Ошибка 'brew command not found' на macOS: причины и решения

Что означает ошибка brew command not found

Ошибка brew: command not found (или zsh: command not found: brew в оболочке zsh) появляется, когда вы пытаетесь выполнить команду brew в терминале macOS, но система не может найти исполняемый файл этой команды. Это означает, что каталог, в котором расположен brew, отсутствует в переменной окружения PATH. Homebrew — это менеджер пакетов для macOS, и без него вы не сможете устанавливать или обновлять программное обеспечение через терминал.

Типичный полный текст ошибки:

zsh: command not found: brew

или

bash: brew: command not found

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

1. Homebrew не установлен. Вы пытаетесь использовать команду brew, но сама программа Homebrew отсутствует в системе.
2. Путь к Homebrew не добавлен в PATH. Homebrew установлен (например, в /opt/homebrew/bin для Mac с Apple Silicon или /usr/local/bin для Intel), но этот каталог не включён в переменную PATH, поэтому терминал не знает, где искать исполняемый файл.
3. Конфигурационный файл оболочки не загружается. Терминал использует оболочку (например, zsh), но конфигурационные файлы (такие как ~/.zshrc), где прописан PATH, не загружаются при запуске нового сеанса.
4. Повреждение установки Homebrew. Файлы Homebrew могли быть повреждены при установке или после обновления системы.

Способ 1: Установка Homebrew

Если Homebrew не установлен, начните с его установки. Это самый простой и распространённый способ решения.

1. Откройте Терминал (Terminal) в macOS.
2. Выполните официальную команду установки:

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

3. Следуйте инструкциям на экране. Установщик попросит ввести пароль администратора и подтвердить нажатием Enter.
4. После завершения установки добавьте Homebrew в PATH, если установщик не сделал это автоматически. Для Mac с Apple Silicon (M1/M2/M3) выполните:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Для Mac с Intel:

echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv)"

5. Закройте и снова откройте терминал или выполните source ~/.zprofile.

Способ 2: Добавление пути Homebrew в переменную PATH

Если Homebrew уже установлен, но команда brew не распознаётся, скорее всего, путь кbrew не добавлен в PATH. Это часто случается после обновления macOS или при использовании кастомных настроек оболочки.

1. Определите, какая оболочка вы используете:

echo $SHELL

Обычно вывод: /bin/zsh (по умолчанию с macOS Catalina) или /bin/bash.

2. Откройте конфигурационный файл для вашей оболочки в текстовом редакторе (например, с помощью nano или vim):
   • Для zsh: nano ~/.zshrc
   • Для bash: nano ~/.bash_profile или nano ~/.bashrc
3. Добавьте в конец файла строку с путём к Homebrew:
   • Для Apple Silicon (Mac на чипе M1 и новее):

     export PATH="/opt/homebrew/bin:$PATH"
     

   • Для Intel:

     export PATH="/usr/local/bin:$PATH"
     

4. Сохраните файл (в nano: Ctrl + O, затем Enter, затем Ctrl + X).
5. Примените изменения, выполнив:

source ~/.zshrc   # для zsh

или

source ~/.bash_profile   # для bash

Если вы не уверены в имени файла, можно просто перезапустить терминал.

6. Проверьте, что brew теперь доступен:

which brew

Вывод должен показать путь, например /opt/homebrew/bin/brew.

Способ 3: Проверка и перезагрузка оболочки

Иногда изменения в PATH не применяются из-за того, что терминал использует другую оболочку или конфигурационные файлы загружаются некорректно.

1. Убедитесь, что вы редактировали правильный конфигурационный файл. macOS может использовать несколько файлов:
   • Для zsh: ~/.zshrc (для интерактивных оболочек) и ~/.zprofile (для login-оболочек). Если ~/.zshrc не сработал, попробуйте добавить export PATH в ~/.zprofile.
   • Для bash: ~/.bash_profile (для login-оболочек) или ~/.bashrc (для интерактивных не-login-оболочек).
2. Если вы не знаете, какая оболочка активна, выполните:

ps -p $$ -o comm=

Это покажет текущую оболочку.

3. После редактирования файла перезапустите терминал полностью (закройте окно и откройте заново) или выполните:

exec $SHELL -l

Это перезапустит оболочку как login-оболочку, загрузив все конфиги.

4. Проверьте PATH:

echo $PATH

Убедитесь, что путь к Homebrew (например, /opt/homebrew/bin) присутствует в выводе.

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

Если предыдущие способы не помогли, возможно, установка Homebrew повреждена. В этом случае выполните полную переустановку.

⚠️ Важно: Переустановка удалит все установленные через Homebrew пакеты. Создайте резервную копию списка пакетов: brew list > brew_backup.txt.

1. Удалите Homebrew:

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

2. Убедитесь, что удалены все файлы:

sudo rm -rf /opt/homebrew   # для Apple Silicon
sudo rm -rf /usr/local/Homebrew   # для Intel

3. Установите Homebrew заново, как описано в Способе 1.

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

Чтобы избежать повторения ошибки:

• Всегда используйте официальный скрипт установки Homebrew. Не скачивайте и не перемещайте файлы вручную.
• После установки проверьте PATH: выполните echo $PATH и убедитесь, что путь к Homebrew (например, /opt/homebrew/bin) присутствует.
• Обновляйте Homebrew регулярно: brew update и brew upgrade.
• Если вы меняете оболочку (например, с bash на zsh), убедитесь, что конфигурационные файлы новой оболочки содержат настройки PATH.
• При обновлении macOS проверяйте, не сбросились ли настройки PATH. Иногда требуется повторно добавить Homebrew в конфигурационные файлы.