Как установить Homebrew на macOS за 5 минут: полная инструкция

Введение / Зачем это нужно

Homebrew — это менеджер пакетов для macOS, который позволяет устанавливать инструменты, языки программирования и утилиты непосредственно из терминала. После установки вы сможете быстро добавлять необходимые программы (например, node, python3, git) и управлять ими с помощью простых команд brew install, brew update и brew upgrade.

Требования / Подготовка

• macOS 11 (Big Sur), 12 (Monterey) или 13 (Ventura) (или более новая версия).
• Права администратора для выполнения скрипта установки.
• Доступ к терминалу (/Applications/Utilities/Terminal.app).
• Рекомендуется предварительно установить Xcode Command Line Tools (см. первый шаг).

Пошаговая инструкция

Шаг 1: Установка Xcode Command Line Tools

Homebrew требует установленный интерфейс командной строки Xcode. Если у вас его еще нет, запустите команду:

xcode-select --install

Следуйте инструкциям установщика. После завершения вы получите необходимые компиляторы и утилиты.

Шаг 2: Установка Homebrew

Откройте терминал и выполните официальный скрипт установки:

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

Скрипт автоматически определит тип процессора (Intel/Apple Silicon) и выполнит необходимые шаги. Для большинства пользователей не требуется дополнительных параметров.

Шаг 3: Добавьте Homebrew в PATH (если необходимо)

Для корректной работы brew из любого терминала добавьте переменную окружения в профиль оболочки.

Apple Silicon Mac (M1, M2 и т. д.)

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

Intel Mac

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

Если вы используете zsh как основную оболочку (стандартно на macOS), файл ~/.zprofile — правильный выбор.

Шаг 4: Проверьте, что Homebrew работает

Запустите две команды по очереди:

brew --version
brew doctor

Если вывод не содержит ошибок, установка успешна. brew --version показывает номер версии и дату сборки, а brew doctor проверяет возможные проблемы с системными зависимостями.

Проверка результата

После успешной установки вы можете:

• Установить первый пакет, например, git:

  brew install git
  

• Обновить формулы до последних версий:

  brew update && brew upgrade
  

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

  git --version
  

Возможные проблемы

• Permission denied при запуске скрипта – убедитесь, что вы вошли в систему под пользователем с правами администратора, и повторите установку. Если проблема сохраняется, запустите скрипт с sudo (если это поддерживается).
• Homebrew уже установлен – скрипт обнаружит существующую установку и предложит обновиться. Вы можете принудительно переустановить, удалив папку /usr/local/Homebrew (Intel) или /opt/homebrew (Apple Silicon) перед повторным запуском скрипта.
• Отсутствие Homebrew в PATH – после установки скрипт может не добавить необходимые строки в конфигурационный файл. Проверьте содержимое ~/.zprofile или ~/.bash_profile и убедитесь, что строка eval "$(...)" присутствует.
• Apple Silicon Mac не находит brew – убедитесь, что вы используете zsh (или bash) и что файл ~/.zprofile был перезагружен (source ~/.zprofile). Перезагрузите терминал, если необходимо.

Эти советы помогут быстро решить распространённые трудности и продолжить работу с Homebrew.