macOS: brew — command not found после установки Homebrew (Apple Silicon)

#Почему команда не найдена

На Mac с процессором Apple (M1, M2, M3 и новее) Homebrew устанавливается в /opt/homebrew, а не в /usr/local, как на Intel. Каталог /opt/homebrew/bin не входит в PATH по умолчанию, поэтому после установки терминал выводит zsh: command not found: brew. Установщик в конце показывает команды, которые нужно выполнить для добавления в PATH — если их пропустить, brew не будет найден. Исправление — одна строка в ~/.zprofile.

#Причины

#Порядок

1. Проверьте, установлен ли Homebrew: ls /opt/homebrew/bin/brewНа Mac откройте «Терминал» через Finder → «Программы» → «Утилиты» → «Терминал». Выполните uname -m: arm64 означает Apple Silicon, x86_64 — Intel (если Терминал запущен под Rosetta, это нужно отдельно учитывать). Затем проверьте наличие исполняемого файла: ls -l /opt/homebrew/bin/brew для Apple Silicon или /usr/local/bin/brew для Intel. Если файл существует, переустанавливать Homebrew не требуется — сначала исправьте путь к команде.
2. Если файл найден, добавьте Homebrew в PATH командой shellenvЕсли brew находится в /opt/homebrew/bin/brew, выполните в терминале eval "$(/opt/homebrew/bin/brew shellenv)": это добавит текущему сеансу нужные переменные окружения. Для сохранения на будущее откройте nano ~/.zprofile, добавьте в конец только один раз eval "$(/opt/homebrew/bin/brew shellenv)", сохраните Ctrl+O → Enter → Ctrl+X. На Intel используйте /usr/local/bin/brew вместо /opt/homebrew/bin/brew. Перед изменением сделайте копию профиля.
3. Выберите способ в командной строке или терминалеЕсли предыдущие действия не помогли, прочитайте назначение каждого варианта ниже. Не выполняйте их все подряд: выбирайте только соответствующий вашей ситуации.
   Выберите подходящий вариант — это не команды для последовательного выполнения

   Вариант 1Узнать архитектуру и оболочку

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Узнать архитектуру и оболочку

   uname -m

   echo $SHELL

   Вариант 2Не добавлять строку в ~/.zprofile многократно командой >> без проверки

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Не добавлять строку в ~/.zprofile многократно командой >> без проверки

   # Для Apple Silicon (arm64), если файл действительно существует

   eval "$(/opt/homebrew/bin/brew shellenv)"

   # Чтобы сохранить после перезапуска: откройте nano ~/.zprofile и ОДИН РАЗ добавьте

   # eval "$(/opt/homebrew/bin/brew shellenv)"

   command -v brew

   brew --version

   Вариант 3Intel Mac

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Intel Mac

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

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

   Вариант 4Проверка PATH и состояния

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Проверка PATH и состояния

   echo $PATH | tr ':' '\n' | head

   which brew

   brew doctor

   Вариант 5Установка Homebrew официальным скриптом (проверьте адрес на brew.sh перед запуском)

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Установка Homebrew официальным скриптом (проверьте адрес на brew.sh перед запуском)

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

   Вариант 6Установка инструментов командной строки Xcode

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Установка инструментов командной строки Xcode

   xcode-select --install

4. Проверьте командой brew --version и which brewВ новом Терминале выполните brew --version и command -v brew. Если показаны версия и абсолютный путь, команда доступна; для arm64 нативный Homebrew обычно находится под /opt/homebrew. Если brew --version работает, но IDE или программа по-прежнему не видит его, проверьте, как эта программа наследует переменную PATH, и перезапустите именно её.
5. Выполните brew doctor и устраните предупрежденияПосле восстановления команды выполните brew doctor и прочитайте предупреждения. Инструмент может указывать на устаревшую версию Command Line Tools, несовместимые права или несколько установок Homebrew. Не выполняйте автоматически все предложенные команды с sudo: сначала выясните их последствия и сохраните настройки. Отсутствие предупреждений — полезный признак, но не обязательное условие для работы каждой команды brew.
6. Если файла нет, установите Homebrew официальным скриптом сТолько если исполняемого файла нет в ожидаемых каталогах, откройте официальный сайт https://brew.sh/, ознакомьтесь с актуальной командой установки и требованиями. Проверьте адрес страницы и сам установочный сценарий перед выполнением — он меняет локальную конфигурацию и может запросить пароль администратора. После установки следуйте точным указаниям установщика о добавлении brew shellenv в PATH, а не копируйте старую инструкцию для чужой архитектуры.
7. Если вы используете bash или fish, добавьте строку в соответствующий файлЕсли вы используете bash, а не стандартную zsh, проверьте echo $SHELL и добавьте нужную строку eval "$(.../brew shellenv)" в ~/.bash_profile для логин-сеанса. Для fish Homebrew предлагает иной синтаксис (fish_add_path/brew shellenv для fish), поэтому используйте официальную инструкцию под эту оболочку, а не строку из zsh. Откройте новую сессию, затем проверьте command -v brew.
8. Установите Xcode Command Line Tools, если их нетЕсли установщик Homebrew сообщает, что отсутствуют инструменты разработчика, в Терминале выполните xcode-select --install. В появившемся системном окне подтвердите установку и дождитесь её завершения; затем проверьте xcode-select -p. Если система отвечает, что инструменты уже установлены, не удаляйте их папку ради повторной установки: сначала проверьте активный путь и обновления macOS.

#После исправления

Проверьте, что brew install wget проходит без ошибок и что brew --prefix выводит /opt/homebrew. Если вы мигрировали с Intel-Mac через Time Machine, старый Homebrew в /usr/local работает через Rosetta и может мешать: убедитесь, что в PATH первым стоит /opt/homebrew/bin, и переустановите пакеты (brew bundle dump на старой машине и brew bundle на новой).