macOS Tahoe 26: Homebrew не устанавливается

Homebrew — это менеджер пакетов. Проще говоря, он помогает устанавливать инструменты командой вроде brew install python вместо ручного поиска, скачивания и обновления каждого компонента.

Ошибка установки обычно относится не к одной причине, а к одному из пяти уровней:

Самый важный принцип: не повторяйте одну и ту же команду вслепую. После каждого исправления выполните короткую проверку. Так будет понятно, какой слой уже исправлен, а какой всё ещё блокирует установку.

На чистой системе Homebrew может потребовать набор инструментов для сборки и работы с Unix-командами. Apple распространяет Command Line Tools отдельно от полной среды разработки. В этот пакет входят компилятор, SDK, страницы справки и другие инструменты, но он не заменяет полный Xcode: некоторые команды, включая xcodebuild, относятся именно к Xcode. Это различие описано в официальной инструкции по установке Command Line Tools.

У Homebrew есть и собственные требования к установке. Официальный установщик выбирает поддерживаемый каталог по архитектуре:

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

Есть ещё три скрытые причины:

1. После обновления macOS версия Command Line Tools может оказаться несовместимой с новой системой.
2. Текущая сессия терминала может не знать о новом пути Homebrew, даже если установка уже завершилась.
3. Общий или школьный Mac может быть управляемым устройством. В этом случае локальный пользователь не сможет установить системный пакет или изменить нужные каталоги.

Сначала проверьте, видит ли macOS каталог разработчика:

xcode-select -p

Возможные результаты:

• путь /Library/Developer/CommandLineTools — пакет Command Line Tools выбран;
• путь к приложению Xcode — активным назначен полный Xcode;
• сообщение об ошибке — инструменты не установлены или путь настроен неправильно.

Если инструменты не найдены, используйте официальный системный запрос:

xcode-select --install

После этого должно появиться окно установки. В нём подтвердите загрузку и лицензионное соглашение. Apple прямо указывает эту команду как штатный способ установки Command Line Tools через Terminal. Инструкция и пример вывода находятся в документации Apple для установки пакета.

Если окно не появляется, не переходите к форумным скриптам. Сначала откройте System Settings и проверьте Software Update. После крупного обновления macOS Apple рекомендует заново проверить наличие совместимой версии Command Line Tools. Версию установленного пакета можно посмотреть так:

pkgutil --pkg-info=com.apple.pkg.CLTools_Executables

Смотрите на поля version, location и install-time. Наличие записи не означает, что выбран правильный активный каталог, поэтому после проверки снова выполните:

xcode-select -p

Не нужно устанавливать полный Xcode только ради Homebrew. Для базовых Unix-команд достаточно Command Line Tools. Полный Xcode понадобится, если учебный курс использует инструменты, которых в отдельном пакете нет.

Важно: не удаляйте каталог /Library/Developer/CommandLineTools и не меняйте системные права рекурсивными командами, если не понимаете последствия. Сначала используйте штатное обновление Apple и сохраните исходный текст ошибки.

Сообщение zsh: command not found: brew не всегда означает, что Homebrew отсутствует. Часто терминал просто не знает, где искать исполняемые файлы.

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

Сначала проверьте, есть ли каталог Homebrew:

ls -la /opt/homebrew/bin/brew

Для Intel Mac используйте:

ls -la /usr/local/bin/brew

Если один из файлов найден, загрузите настройки Homebrew для текущей оболочки:

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

На Intel Mac команда будет такой:

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

Затем проверьте:

brew --version
which brew
brew --prefix

Homebrew документирует команду brew shellenv: она добавляет нужные каталоги в PATH, а также настраивает связанные переменные окружения. Для постоянной загрузки на macOS обычно используется файл ~/.zprofile. Добавьте строку, соответствующую архитектуре:

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

Для Intel:

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

После этого закройте окно Terminal, откройте новое и повторите:

brew --version

Официальное описание shellenv, поддерживаемых оболочек и переменных окружения приведено в справке Homebrew по командам.

Не вставляйте обе строки одновременно. Если добавить путь Apple Silicon на Intel Mac или наоборот, диагностика станет менее понятной. Архитектуру можно узнать командой:

uname -m

Результат arm64 указывает на Apple Silicon. Результат x86_64 — на Intel либо на терминал, работающий через слой совместимости. Сам этот вывод не устанавливает Homebrew, но помогает выбрать правильный путь.

Если появляется Permission denied, сначала выясните, где именно возник отказ. Полезны команды:

whoami
id -Gn
ls -ld /opt/homebrew
ls -ld /usr/local

Важны три сценария.

Личная учётная запись с правами администратора

Используйте официальный установщик Homebrew и внимательно прочитайте список действий перед подтверждением. После первоначальной установки дальнейшие команды brew install обычно не требуют постоянного запуска через sudo, поскольку стандартный префикс выбран именно для работы без такого режима. Это указано в документации Homebrew.

Если команда предлагает изменить владельца большого количества системных каталогов, остановитесь. Старые советы с chown -R, удалением случайных директорий или отключением защиты могут повредить систему и не являются универсальным исправлением.

Обычная учётная запись без администратора

На Mac без прав администратора установка системных инструментов может быть невозможна. Даже если часть файлов Homebrew удастся создать в домашней папке, это не превращает компьютер в полноценную учебную среду: курс может потребовать компилятор, сетевые инструменты или другие компоненты, управляемые политиками устройства.

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

Школьный или общий Mac с управлением устройства

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

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

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

• школьная сеть фильтрует внешние соединения;
• прокси требует отдельной настройки;
• DNS отвечает нестабильно;
• VPN или корпоративный фильтр разрывает загрузку;
• удалённый репозиторий временно недоступен.

Не меняйте сразу несколько сетевых параметров. Сначала сохраните полный вывод команды. В Homebrew для диагностики предусмотрены:

brew config
brew doctor

Официальная последовательность Troubleshooting начинается с обновления, повторного запуска обновления, затем brew doctor и анализа предупреждений. Этот порядок описан в официальном руководстве по устранению проблем Homebrew.

После успешного появления команды brew выполните:

brew update
brew doctor

brew doctor может показать предупреждения, которые не мешают обычной работе. Не исправляйте каждую строку автоматически. Читайте, относится ли предупреждение к конкретной команде или пакету, который не устанавливается.

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

Установка считается завершённой не после строки Installation successful, а после трёх последовательных проверок.

Проверка 1: версия и расположение

brew --version
brew --prefix
which brew

Ожидаемый префикс зависит от архитектуры. На Apple Silicon это /opt/homebrew, на Intel — /usr/local. Если which brew показывает другой путь, выясните, не осталась ли старая копия или ручная установка в нестандартном каталоге.

Проверка 2: диагностика окружения

brew doctor
brew config

Сохраните вывод в текстовый файл, если понадобится помощь:

brew config > brew-config.txt
brew doctor > brew-doctor.txt

Не публикуйте вместе с логами пароли, токены, приватные URL репозиториев и личные данные.

Проверка 3: установка небольшого учебного инструмента

Выберите пакет, который действительно нужен текущему курсу. Например:

brew install wget

После установки проверьте:

which wget
wget --version

Если курс посвящён Python, не ставьте сразу длинный список пакетов. Сначала убедитесь, что работает сам Homebrew, затем переходите к отдельной инструкции по настройке Python на Mac. Так проще определить, где появилась ошибка: в менеджере пакетов, конкретной формуле или настройках языка.

После установки закройте Terminal и войдите в новую сессию. Повторите brew --version и which brew. Эта проверка выявляет проблему, когда команда работала только после временного eval, но не была сохранена в профиле оболочки.

Да, удалённый реальный Mac может быть рабочим вариантом, если у него есть доступный терминал, разрешена установка Homebrew и учётная запись имеет необходимые права. Для начинающего важна не только скорость подключения, но и возможность сохранить окружение между занятиями.

Через VNC обычно виден полноценный рабочий стол. Это удобно для первого запуска Terminal и системного диалога Command Line Tools. Через SSH быстрее выполнять команды и сохранять вывод, но графические окна установки могут не отображаться так, как при локальном входе. Веб-консоль может отличаться сочетаниями клавиш и вставкой текста, поэтому первую установку лучше проводить с понятным способом доступа.

Перед началом занятия проверьте:

• Mac отвечает на выбранный способ подключения;
• Terminal открывается;
• команда uname -m возвращает архитектуру;
• sw_vers показывает версию macOS;
• текущая учётная запись может устанавливать разрешённые инструменты;
• после выхода и нового входа brew --version продолжает работать.

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

Отметьте пункты по порядку:

• [ ] xcode-select -p возвращает активный путь.
• [ ] Command Line Tools установлены или выбран полный Xcode.
• [ ] Для Apple Silicon проверен путь /opt/homebrew.
• [ ] Для Intel проверен путь /usr/local.
• [ ] brew --version работает в новом окне Terminal.
• [ ] which brew показывает ожидаемый путь.
• [ ] В ~/.zprofile записана только нужная строка brew shellenv.
• [ ] brew doctor выполнен, предупреждения прочитаны.
• [ ] Сеть не блокирует загрузку учебного пакета.
• [ ] После повторного входа установленный инструмент остаётся доступным.

Если пункт с правами не проходит, не переходите к изменению владельцев каталогов. Если не проходит сеть, не заменяйте источники загрузки случайными зеркалами. Если не проходит PATH, не переустанавливайте Homebrew: сначала проверьте brew shellenv.

Для длительной работы локальный Mac с полной личной учётной записью обычно проще: не нужно зависеть от школьных политик, удалённого подключения и доступности сети. Но покупка устройства не всегда оправдана для короткого курса. Windows не решает задачу напрямую, если учебные инструкции требуют macOS-инструменты, а виртуальная машина добавляет отдельные проблемы с совместимостью, правами и ресурсами. Если нужно только пройти курс, проверить Homebrew и собрать Python или фронтенд-окружение, аренда удалённого реального Mac у MESHLAUNCH может быть более рациональным промежуточным вариантом — при условии, что среда предоставляет необходимые права и соответствует правилам обучения.

Начните с трёх команд — xcode-select -p, brew --prefix и brew doctor. Если собственного Mac нет или школьный компьютер не позволяет установить инструменты, сначала используйте управляемую удалённую среду, а уже затем решайте, нужен ли вам личный компьютер на постоянной основе.