В терминале появляется сообщение «команда brew не найдена» после установки Homebrew.

Сначала проверьте, завершилась ли установка и существует ли файл brew; если он есть, сверьте путь и загрузку настроек shell, а не переустанавливайте Homebrew и не меняйте системные права наугад.

Эта инструкция подойдёт студентам, которые впервые установили Homebrew и теперь не могут запустить brew.
Если вы переходите с Windows и настраиваете инструменты для курса, здесь разобран порядок проверки терминала.
На управляемом учебном Mac сначала выясните, какие изменения разрешены администратором.

Проверьте, что именно произошло сразу после установки

Сообщение «команда не найдена» означает, что текущая оболочка не смогла обнаружить команду через свой путь поиска. Это не доказывает, что Homebrew отсутствует. Установщик мог завершить работу, но терминал мог не загрузить требуемую настройку.

Запишите две вещи: последние строки установщика и полный текст ошибки. Не ограничивайтесь пересказом «не работает»: сообщение об ошибке и вывод команды помогают отличить незавершённую установку от проблемы с настройкой окружения.

Сначала проверьте, распознаёт ли терминал команду:

brew --version

Если появится номер версии, команда доступна в этой сессии. Если терминал ответит, что команда не найдена, переходите к проверке самого файла. Homebrew объясняет, что после установки нужно выполнить предложенные установщиком действия по настройке shell; пропуск этого шага может помешать запуску команды. Сверьте шаги с официальной инструкцией Homebrew по установке и настройке после установки.

Важно не перепутать повторную установку с исправлением настройки. Если файл brew уже существует, новая установка может добавить путаницу с путями или несколькими экземплярами. В документации Homebrew отдельно описаны проблемы, возникающие при обнаружении нескольких установок и несогласованных путей; сверяйте их с официальным разбором типичных проблем с путями.

Сопоставьте файл brew с путём установки

Путь — это адрес каталога на диске. Префиксом Homebrew называет основное место установки, от которого строится этот адрес. Он влияет на то, где искать исполняемый файл и какую строку shellenv добавить в настройки.

Для стандартной установки Homebrew указывает разные префиксы для Apple Silicon и Intel. В документации приведены /opt/homebrew для Apple Silicon и /usr/local для Intel; это значения по умолчанию, а не гарантия для каждой машины или пользовательской установки. Проверьте эти сведения в FAQ Homebrew о стандартных каталогах установки.

Что вы проверяете Что может объяснить результат Следующее действие
brew --version запускается Команда доступна в текущей сессии Зафиксируйте результат и проверьте, сохраняется ли он в новом окне
Файл brew найден в ожидаемом префиксе, но команда не запускается Вероятно, текущий shell не видит каталог команды Перейдите к проверке shell и его конфигурации
Файл не найден по стандартному пути Возможно, установка не завершилась или использован другой префикс Сверьте вывод установщика и фактическое расположение
В терминале указано несколько разных расположений Возможны несколько установок или старая запись пути Не удаляйте файлы: сначала сравните результаты с официальным разбором путей

Команды для проверки зависят от подтверждённого префикса. Для стандартных расположений из официальной документации можно проверить существование файла так:

test -x /opt/homebrew/bin/brew && echo "Файл найден"
test -x /usr/local/bin/brew && echo "Файл найден"

Эти проверки не устанавливают программу и не меняют настройки. Если ни одна строка не вывела сообщение, это не повод подставить другой каталог наугад. Посмотрите, какой путь напечатал установщик, и проверьте его. Если в процессе установки использовался нестандартный префикс, применяйте именно его.

Справочник Homebrew описывает команды, связанные с префиксом и настройкой окружения. Например, brew --prefix помогает узнать префикс уже доступной установки, а brew shellenv — получить команды настройки окружения. Сверяйте назначение этих команд с официальной страницей команд Homebrew. Если brew пока не распознаётся, команда brew --prefix тоже не сможет помочь: сначала подтвердите расположение исполняемого файла.

Проверьте оболочку и файл её настроек

Shell, или оболочка, — программа, которая принимает команды в терминале и запускает их. Разные оболочки могут читать разные файлы при открытии терминала. Поэтому совет добавить строку в произвольный файл может ничего не исправить.

Узнайте, какую оболочку указывает текущая сессия:

echo $SHELL

Не считайте результат универсальным ответом на вопрос о файле настроек. Настройки приложения «Терминал» могут влиять на то, какую оболочку запускает окно. Apple описывает, где посмотреть и изменить используемую оболочку, в руководстве по выбору оболочки в Терминале. Если вы работаете не в стандартном приложении «Терминал», учитывайте настройки именно того приложения, которым пользуетесь.

Затем вернитесь к выводу Homebrew Installer. Если он предложил добавить строку eval "$(<путь>/bin/brew shellenv)" в конкретный файл, проверьте, есть ли эта строка в нужном файле. Подставлять нужно путь вашей реальной установки, а не пример из чужой инструкции. Официальный установщик Homebrew показывает после установки shell-команду, которую следует использовать; сверяйте точную форму с официальными шагами настройки.

Проверьте файл текстовым редактором или командой просмотра. Не стирайте его содержимое и не заменяйте целиком готовым шаблоном из интернета. В нём могут храниться другие нужные настройки. Если строки Homebrew нет, добавляйте только ту, которую предлагает официальная инструкция для вашего префикса и оболочки.

Не запускайте команды из случайных форумных ответов, если они скачивают и выполняют скрипт, меняют владельца системных каталогов или требуют расширить права. Сначала выясните, что именно команда меняет. В руководстве Apple по работе с Терминалом описано, как вводить команды и использовать его настройки; для базовых действий можно свериться с руководством пользователя Терминала.

Разберите вопросы, которые возникают во время настройки

Почему Homebrew установлен, но команда всё равно не находится?

Самая частая причина в этом сценарии — файл существует, но путь к его каталогу не загружен в текущую оболочку. PATH — список каталогов, в которых shell ищет команды. Если каталог Homebrew отсутствует в PATH, короткая команда brew не сработает, даже когда файл на диске на месте. Сверьте префикс, затем настройку shellenv, предложенную установщиком.

Как понять, установился ли Homebrew полностью?

Начните с brew --version. Если команда не распознаётся, проверьте наличие исполняемого файла в префиксе, который напечатал установщик или который соответствует вашей конфигурации. Сопоставьте это с финальными строками установки: если установка прервалась до завершения, сначала изучите ошибку установщика, а не пытайтесь маскировать её изменением PATH.

Какой файл настроек shell нужно открыть?

Сначала определите оболочку и выясните, какой профиль читается при запуске именно вашего терминала. Не переносите строку из инструкции для другого shell автоматически. Затем сравните файл с указаниями Homebrew Installer и добавьте только корректную строку shellenv, если её нет. Не перезаписывайте целый файл и сохраните исходный вариант перед изменениями.

Что делать, если в новом окне терминала brew опять не найден?

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

Откройте новое окно и проверьте результат

Изменение файла настроек не всегда меняет уже открытое окно. Закройте терминал и откройте новое окно, чтобы shell заново прочитал настройки. В руководстве Apple описаны параметры запуска окон Терминала; если поведение нового окна отличается от ожидаемого, проверьте настройки запуска и общие параметры Терминала.

В новом окне выполните команды по порядку:

echo $SHELL
brew --version
brew --prefix

Первая команда показывает оболочку текущей сессии. Вторая проверяет, распознаётся ли Homebrew. Третья возвращает префикс доступной установки. Если первые две команды работают, а результат последней отличается от ожидаемого, не исправляйте путь вслепую: проверьте, нет ли нескольких установок или записей PATH от прежних настроек.

Если команда по-прежнему недоступна, возвращайтесь к трём точкам: какая оболочка запускается, какой файл она читает и совпадает ли путь в shellenv с реальным расположением brew. Официальная страница Homebrew по устранению неполадок помогает системно собирать сведения о проблеме. Если устройство принадлежит учебному заведению и вы не можете менять нужные настройки, не пытайтесь обходить ограничения или получать дополнительные права. Передайте администратору полный текст ошибки и результаты безопасных проверок.

Выберите следующий шаг по результатам проверки

  • Если установка явно прервалась и файл brew не найден по пути, который указал установщик, сначала разберите причину остановки по её сообщению. Повторять установку имеет смысл только после выяснения причины и проверки официальной инструкции.
  • Если файл существует, но команда не распознаётся, не переустанавливайте Homebrew. Проверьте shell, файл конфигурации и строку shellenv для действительного префикса.
  • Если brew работает только в текущем окне, проверьте настройки нового сеанса и файл, который читается при запуске оболочки. После исправления повторите проверку в новом окне.
  • Если настройки заблокированы школьным администратором, не меняйте владельца каталогов, не запускайте команды с повышенными правами и не обходите управление устройством. Попросите администратора подтвердить разрешённый способ настройки.
  • Если курс требует Mac, но на текущем устройстве нельзя установить нужные инструменты, сначала уточните требования курса и допустимые способы доступа. Не арендуйте среду только из-за ошибки PATH: если Homebrew уже установлен, обычно нужно исправить конфигурацию, а не менять компьютер.

Преимущества проверки пути и shell-конфигурации — вы сохраняете существующую установку и понимаете причину ошибки. Ограничение такого подхода — он не исправит незавершённую установку или запрет администратора; в этих случаях нужен разбор исходной ошибки или помощь ответственного специалиста. Для команд, доступных в конкретном учебном курсе, проверяйте инструкцию курса и не устанавливайте дополнительные пакеты «на всякий случай».

Если упираетесь не в забытый shellenv, а в то, что школьный компьютер не даёт подготовить требуемую среду, сравните требования курса с доступными вариантами. Вы можете посмотреть варианты доступа к Mac через MACCOME и проверить, подходит ли предложенный формат для ваших учебных задач. Перед выбором уточните условия доступа и нужные инструменты; для одной ошибки настройки сначала достаточно пройти официальные шаги Homebrew. Если курс действительно требует работы в среде Mac, изучите страницу заказа Mac mini и сопоставьте условия с длительностью курса. Аренда не заменяет собственный компьютер для длительной постоянной работы и не решит задачу, если вам необходимы физические интерфейсы или настройки, запрещённые учебным заведением.