Homebrew команда не найдена: решение проблемы в macOS за 5 минут

Что означает ошибка Homebrew не найден

Когда вы запускаете команду brew в терминале и получаете сообщение «command not found», это означает, что исполняемый файл brew отсутствует в каталогах, включенных в переменную окружения PATH. Чаще всего это происходит, потому что Homebrew не установлен или его каталог (/usr/local/bin, /opt/homebrew/bin и т. п.) не добавлен в PATH.

bash: brew: command not found

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

• Homebrew не установлен на системе.
• Отсутствует в PATH: каталог, содержащий brew, не включен в переменную окружения PATH.
• Повреждение установки: поврежденные файлы или некорректные права доступа.
• Несовместимость с версией macOS: конфликт с системными ограничениями (например, системная защита интегральности или новые требования к безопасности).

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

Способ 1: Установить Homebrew через официальный скрипт

1. Откройте Terminal.
2. Выполните команду, которая скачивает и запускает установщик:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

3. Следуйте инструкциям на экране (скрипт предложит добавить Homebrew в PATH автоматически).

Способ 2: Добавить Homebrew в PATH вручную

Если после установки команда brew по-прежнему не найдена, добавьте Homebrew в вашу оболочку. Для Zsh (~/.zshrc) или Bash (~/.bash_profile) добавьте строку:

eval "$(/usr/local/bin/brew shellenv)"

Сохраните файл, затем перезапустите терминал (source ~/.zshrc или source ~/.bash_profile).

Способ 3: Переустановить Homebrew

1. Удалите старую установку (необязательно).
2. Запустите скрипт установки еще раз с флагом --force:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" --force
   

3. Подтвердите удаление и выполните шаги по установке. Скрипт переустановит Homebrew и обновит PATH.

Способ 4: Проверить и восстановить установку

1. Запустите brew doctor, чтобы выявить проблемы.
2. Выполните обновление и принудительный апгрейд:

   brew update
   brew upgrade --force
   

3. После завершения запустите brew doctor снова — если ошибок нет, команда brew должна работать.

Способ 5: Использовать альтернативный пакетный менеджер

Если проблемы с Homebrew сохраняются, рассмотрите установку MacPorts или использование системного менеджера пакетов. Это позволит вам выполнять аналогичные операции без Homebrew. Установка MacPorts выполняется через официальный инсталлятор с сайта macports.org.

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

• Регулярно обновляйте Homebrew: запускайте brew update && brew upgrade каждые несколько недель.
• Проверяйте PATH: периодически проверяйте, что каталог Homebrew (/usr/local/bin или /opt/homebrew/bin) присутствует в echo $PATH.
• Следите за ошибками: после изменений в системе запускайте brew doctor и исправляйте сообщения об ошибках сразу.
• Избегайте ручного редактирования скриптов: используйте официальные команды Homebrew; ручные изменения могут нарушить корректную работу PATH.