macOS: git — xcrun: error: invalid active developer path

  • Обновлено
  • Чтение ≈ 4 минуты
  • Нужны права администратора

Краткий ответ

Ошибка xcrun: invalid active developer path появляется после обновления macOS, когда утилиты командной строки Xcode слетают. Выполните xcode-select --install, примите лицензию или сбросьте путь командой xcode-select --reset.

В этой статье
  1. Откуда берётся
  2. Как исправить
  3. Если установка не запускается
invalid active developer path
xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun
По-русскиGit и другие утилиты не находят установленные инструменты разработчика.

#Откуда берётся

В macOS команда /usr/bin/git может вызывать инструменты разработчика Apple через xcrun; при повреждённом или отсутствующем активном каталоге разработчика появляется invalid active developer path. Проверьте xcode-select -p и git --version, прежде чем переустанавливать что-либо.

Возможная причинаКак узнатьЧто делать
Окно установки не появилосьДиалог скрыт за другими окнами.Команда ничего не показывает.Выполните xcode-select --install ещё раз или установите вручную с https://developer.apple.com/download/all/ (нужен Apple ID).
Сервер обновлений недоступенСообщение «Не удаётся найти программное обеспечение».Установка зависает.Проверьте интернет, повторите позже; пакет доступен также через softwareupdate --list.
Нет места на дискеЗагрузка рассчитана на несколько ГБ.Ошибка записи.Освободите 5–10 ГБ.
Установлен Homebrew-версия gitДругой git в PATH.which git указывает на /opt/homebrew/bin/git.Это нормально; проблему решает установка CLT, так как Homebrew тоже зависит от неё.
Лицензия не принятаОшибка о лицензии Xcode.xcodebuild требует согласия.sudo xcodebuild -license accept.
Старая macOSУстаревшие CLT.Несовместимая версия.Скачайте версию для вашей macOS.

#Как исправить

  1. Установите Command Line ToolsНа Mac откройте «Терминал» (Finder → «Программы» → «Утилиты») и выполните xcode-select --install. Если инструменты разработчика отсутствуют, macOS предложит установить Command Line Tools; подтвердите системное предложение. Если появится сообщение, что инструменты уже установлены, не удаляйте их: сначала проверьте активный путь по следующему шагу.
  2. Подтвердите во всплывающем окнеВ появившемся системном диалоге нажмите «Установить», согласитесь с лицензионными условиями Apple и дождитесь завершения. Компьютер должен быть подключён к сети и иметь свободное место. При ошибке загрузки откройте «Системные настройки» → «Основные» → «Обновление ПО» и проверьте доступные инструменты/обновления; не скачивайте неизвестные пакеты инструментов с неофициальных сайтов.
  3. Проверьте путьПосле установки в Терминале выполните xcode-select -p. Для отдельного набора Command Line Tools ожидается /Library/Developer/CommandLineTools; при установленном Xcode допустим путь вида /Applications/Xcode.app/Contents/Developer. Если путь указывает на удалённый каталог или выводится ошибка, посмотрите ls -ld /Library/Developer/CommandLineTools /Applications/Xcode.app/Contents/Developer и переходите к правильному выбору инструментов.
  4. Если установлен XcodeЕсли у вас действительно установлен полный Xcode в /Applications/Xcode.app, откройте Терминал и выполните sudo xcode-select -s /Applications/Xcode.app/Contents/Developer. Введите пароль администратора Mac; он не отображается на экране. Если Xcode установлен с другим именем, узнайте путь в Finder, а не копируйте команду без проверки. Проверьте результат командой xcode-select -p.
  5. Примите лицензию XcodeТолько для полного Xcode, который требует принять лицензию, выполните в Терминале sudo xcodebuild -license accept; для этого нужны права администратора. Если команда не найдена или запрашивает другую настройку, проверьте выбранный путь xcode-select -p. Для отдельного Command Line Tools этот шаг обычно не требуется. После успешной настройки повторите git --version.
  6. Если всё сломаноЕсли путь неверный, сначала попробуйте безопасный сброс выбора: sudo xcode-select --reset, затем проверьте xcode-select -p. Не выполняйте sudo rm -rf /Library/Developer/CommandLineTools автоматически: это удалит установленный набор. Если инструменты действительно повреждены, согласуйте их переустановку и используйте официальные обновления Apple, предварительно сохранив рабочие проекты.
  7. Проверьте gitВ Терминале выполните git --version и xcrun --find git. При успехе увидите версию Git и путь к исполняемому файлу. Затем повторите исходную Git-команду в каталоге проекта. Если ошибка сохранилась, сохраните вывод xcode-select -p, версию macOS («Меню Apple» → «Об этом Mac») и сообщение xcrun для обращения к администратору.
  8. Команды для отдельных ситуацийВыберите только подходящий вариант. Это не одна последовательность: часть команд диагностирует проблему, а часть меняет настройки или данные.
    Выберите подходящий вариант — это не команды для последовательного выполнения
    Вариант 1Установить инструменты командной строки (откроется диалог установки)
    Linux · Терминал (Bash)Команда
    Установить инструменты командной строки (откроется диалог установки)
    xcode-select --install
    Вариант 2Проверка текущего пути разработчика и версии git
    Linux · Терминал (Bash)Команда
    Проверка текущего пути разработчика и версии git
    xcode-select -p
    git --version
    which git
    Вариант 3Сбросить путь разработчика к значению по умолчанию
    Linux · Терминал (Bash)КомандаНужен sudo
    Сбросить путь разработчика к значению по умолчанию
    sudo xcode-select --reset
    Вариант 4Указать полный Xcode как источник инструментов (если установлен)
    Linux · Терминал (Bash)КомандаНужен sudo
    Указать полный Xcode как источник инструментов (если установлен)
    sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
    sudo xcodebuild -license accept
    Вариант 5Опасный rm -rf каталога CommandLineTools удалён
    Linux · Терминал (Bash)С осторожностьюНужен sudo
    Опасный rm -rf каталога CommandLineTools удалён
    # Сначала безопасная попытка сбросить активный путь
    sudo xcode-select --reset
    xcode-select -p

    Команда может изменить состояние системы или её настройки. Проверьте параметры и последствия перед запуском.

    Вариант 6Проверка работы компилятора
    Linux · Терминал (Bash)Команда
    Проверка работы компилятора
    clang --version
    xcrun --find git

#Если установка не запускается

Linux · Терминал (Bash)Команда
Удалён жёстко заданный устаревающий пакет Command Line Tools for Xcode-16.0
# Проверка списка доступных обновлений; имя конкретного CLT зависит от версии macOS
softwareupdate --list

Название пакета в последней команде берите из вывода softwareupdate --list — оно меняется с версиями. После установки перезапустите Терминал, чтобы обновилась переменная PATH.

Так эту ошибку тоже называют

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.