Ошибка «Xcode Command Line Tools not found»: как быстро установить

Что означает ошибка «Xcode Command Line Tools not found»

Эта ошибка возникает, когда вы пытаетесь выполнить в терминале команду, требующую компилятора или утилит из набора разработчика Apple (например, git, make, gcc, clang, ssh), но система не может их найти.

Типичные симптомы:

• При запуске git в новом терминале после обновления macOS появляется всплывающее окно с предложением установить инструменты.
• Команда brew install ... (Homebrew) прерывается с ошибкой, указывающей на отсутствие Command Line Tools.
• Сборка проектов на C/C++, Python (с расширениями) или Rust падает с ошибкой error: unable to find utility "clang".
• Прямая ошибка в терминале: xcode-select: error: command line tools are not installed.

Система macOS, обнаружив отсутствие необходимых утилит, не может выполнить запрошенную операцию и сообщает об этом.

Причины возникновения

1. Чистая установка или обновление macOS. Это самая частая причина. При установке «с нуля» или крупном обновлении системы (например, с Monterey до Sonoma) набор инструментов разработки не переносится и требуется установка заново.
2. Сознательное удаление. Пользователь или скрипт мог удалить папку /Library/Developer/CommandLineTools для освобождения места.
3. Повреждение установки. Прерванная установка, сбой при обновлении или повреждение файлов в результате ошибки диска могут сделать набор неработоспособным.
4. Неполная установка Xcode. Если установлен только Xcode из App Store, но не были установлены дополнительные компоненты (что происходит при первом запуске Xcode), терминальные утилиты могут быть недоступны системно.

Способы решения

Способ 1: Стандартная установка через системный запрос (рекомендуется)

Это самый простой и надежный способ, который использует официальный механизм macOS.

1. Откройте приложение «Терминал» (находится в Программы или через Spotlight).
2. Введите любую команду, требующую инструментов, например:

   git --version
   

   Или просто выполните:

   xcode-select --install
   

3. В появившемся окне нажмите «Установить». Появится стандартное окно установки программ от Apple.
4. Примите лицензионное соглашение. Нажмите «Согласиться».
5. Дождитесь окончания установки. Внизу окна будет отображаться прогресс. После завершения окно закроется автоматически.
6. Проверьте установку:

   xcode-select -p
   

   Успешный вывод: /Library/Developer/CommandLineTools.

⚠️ Важно: Установка требует стабильного интернет-соединения. Не прерывайте процесс. Если окно установки не появилось, попробуйте перезагрузить Mac и повторить шаг 2.

Способ 2: Установка через полный Xcode (если нужен IDE)

Если вы планируете разрабатывать под iOS, macOS или используете специфические инструменты Xcode, проще установить полную IDE.

1. Откройте App Store и найдите «Xcode».
2. Нажмите «Установить». Размер приложения превышает 10 ГБ, процесс займет время.
3. После установки запустите Xcode один раз. Система может запросить установку дополнительных компонентов — согласитесь.
4. Установите командные инструменты через настройки Xcode:
   • В меню Xcode выберите Settings... (Настройки...).
   • Перейдите на вкладку Locations (Расположения).
   • В выпадающем меню Command Line Tools выберите последнюю версию (например, Xcode 15.3).
5. Проверьте в терминале:

   xcode-select -p
   

   Теперь путь должен быть указан внутрь папки Xcode: /Applications/Xcode.app/Contents/Developer.

Способ 3: Ручная загрузка и установка (для корпоративных сетей)

Если у вас ограниченный интернет или вы работаете в сети с прокси, можно скачать пакет вручную.

1. Перейдите на официальную страницу загрузок Apple Developer (требуется бесплатный аккаунт Apple ID):
   https://developer.apple.com/download/all/
2. В поиске введите «Command Line Tools» и найдите последнюю версию, совместимую с вашей macOS (например, «Command Line Tools for Xcode 15.3»).
3. Скачайте .pkg-файл (размер ~1.5 ГБ).
4. Запустите скачанный установщик и следуйте инструкциям.
5. После установки проверьте:

   xcode-select -p
   

Способ 4: Сброс и переустановка (если инструменты «сломаны»)

Если предыдущие способы не помогли, возможно, конфигурация системы повреждена.

1. Удалите текущую (поврежденную) установку:

   sudo rm -rf /Library/Developer/CommandLineTools
   

   Ввод пароля администратора потребуется.
2. Перезагрузите Mac.
3. Повторите Способ 1 (стандартную установку через xcode-select --install).

Профилактика

• Не удаляйте папку /Library/Developer/CommandLineTools вручную, если не планируете полной переустановки системы. Для очистки используйте sudo rm -rf только в крайних случаях.
• После крупного обновления macOS (например, с 13.x до 14.x) проверяйте работу git или brew в новом терминале. Система, скорее всего, сама предложит установить инструменты.
• Если вы используете Homebrew, после установки CLT выполните brew doctor — это проверит окружение на наличие распространенных проблем.
• Для корпоративных Mac с управляемым доступом: убедитесь, что политики безопасности не блокируют установку пакетов от Apple. Возможно, потребуется обращение к системному администратору.