Установка и использование Homebrew на macOS: Полное руководство

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

Homebrew (его часто называют просто brew) — это незаменимый инструмент для любого пользователя macOS, который работает в терминале. Он решает главную проблему установки Unix-совместимого ПО: автоматически собирает и устанавливает все необходимые зависимости.

Что вы получите, освоив Homebrew:

• Скорость: Установка сложных инструментов (как ffmpeg, node, wget) занимает секунды вместо часов ручной настройки.
• Управляемость: Все установленные через brew программы находятся в одной системе. Их легко обновлять одной командой или полностью удалять.
• Изоляцию: Пакеты устанавливаются в отдельные директории (/usr/local/Cellar или /opt/homebrew/Cellar), не загрязняя системные папки.
• Совместимость: Многие современные инструменты разработки (Docker, Kubernetes CLI, языки программирования) рекомендуют устанавливать именно через Homebrew.

Это руководство проведёт вас от первой команды до уверенного использования.

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

Перед началом убедитесь, что:

1. У вас есть учетная запись администратора на Mac.
2. Установлены Xcode Command Line Tools. Homebrew может предложить их установить автоматически, но лучше проверить заранее. Выполните в терминале:

   xcode-select --install
   

   Если команда возвращает ошибку или сообщение, что инструменты уже установлены, всё в порядке.
3. Вы знакомы с основами работы в Терминале (Terminal.app или iTerm2).
4. У вас есть стабильное подключение к интернету.

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

Официальный и единственный рекомендуемый способ установки — выполнить скрипт с официального сайта.

1. Откройте Терминал (через Spotlight Cmd+Пробел → "Терминал" или из /Программы/Утилиты/).
2. Вставьте и выполните следующую команду:

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

   Что делает команда: curl скачивает установочный скрипт, -fsSL — флаги для тихого и безопасного скачивания, bash -c — выполняет полученный скрипт.
3. Скрипт выдаст информационные сообщения и спросит, хотите ли вы продолжить. Нажмите Enter для подтверждения.
4. Вам будет предложено ввести пароль администратора. Ввод пароля в терминале не отображается (символы не появляются) — это нормально. Просто введите пароль и нажмите Enter.
5. Установка займет от 5 до 15 минут в зависимости от скорости интернета. В конце скрипт выдаст сообщения об успешной установке и, возможно, предложит выполнить команды для добавления Homebrew в ваш PATH.

⚠️ Важно: Если вы используете Mac на базе Apple Silicon (M1/M2/M3), Homebrew по умолчанию установится в /opt/homebrew. Для Intel Macs — в /usr/local. Скрипт сам определит архитектуру.

Шаг 2: Настройка окружения (PATH)

После установки может потребоваться настроить переменную окружения PATH, чтобы система "видела" команды brew и установленные через него программы.

1. Скрипт установки обычно сам предлагает нужные команды. Если вы пропустили этот шаг, выполните в зависимости от вашей оболочки:
   • Для Zsh (оболочка по умолчанию в macOS начиная с Catalina):

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

   • Для Bash (если вы её используете):

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

2. Перезапустите Терминал или выполните source ~/.zprofile / source ~/.bash_profile.

Шаг 3: Проверка корректной установки

Выполните две ключевые команды для диагностики:

brew --version

Вывод должен показать версию Homebrew (например, Homebrew 4.2.0).

brew doctor

Эта команда проверит вашу систему на возможные проблемы с конфигурацией Homebrew.

• Идеальный результат: Your system is ready to brew.
• Если есть предупреждения (например, о неисправных симлинках или устаревших версиях Xcode), внимательно прочитайте их и следуйте предложенным инструкциям по исправлению.

Шаг 4: Ваши первые команды Homebrew

Теперь Homebrew готов к работе. Освойте базовый цикл: Поиск → Установка → Использование → Обновление/Удаление.

4.1 Поиск пакетов

Чтобы найти программу, например, утилиту для скачивания видео yt-dlp:

brew search yt-dlp

Или для более широкого поиска:

brew search wget

4.2 Получение информации о пакете

Перед установкой полезно узнать, что входит в пакет, его зависимости и лицензию:

brew info wget

Вывод покажет: текущую версию, описание, список зависимостей, размер и команду для установки.

4.3 Установка пакета

Установите wget — мощную утилиту для загрузки файлов:

brew install wget

Homebrew автоматически скачает исходный код (или бинарник), проверит целостность, соберёт (если нужно) и установит пакет со всеми зависимостями.

4.4 Запуск установленного ПО

После установки команды программы доступны сразу в терминале. Проверьте wget:

wget --version

4.5 Обновление formulae (основных пакетов)

Регулярно обновляйте список доступных пакетов и сами пакеты:

brew update        # Обновляет внутренний репозиторий Homebrew (формулы)
brew upgrade       # Обновляет все установленные пакеты до последних версий

4.6 Удаление пакета

Если программа вам больше не нужна:

brew uninstall wget

Это удалит файлы пакета, но сохранит конфигурационные файлы в вашей домашней директории (если они были созданы).

4.7 Очистка

Со временем в кэше накапливаются старые версии пакетов и временные файлы сборки. Освободите место:

brew cleanup        # Удаляет старые версии установленных пакетов
brew cleanup -s     # Удаляет также и кэш скачивания (скачанные .tar.gz архивы)

Шаг 5: Работа с Casks (установка GUI-приложений)

Homebrew не ограничивается консольными инструментами. Homebrew Cask — это расширение для управления графическими приложениями (.dmg, .pkg).

• Поиск GUI-приложений: brew search --cask firefox
• Установка: brew install --cask firefox (или просто brew install firefox, если имя не конфликтует с формулой).
• Удаление: brew uninstall --cask firefox
• Список установленных Cask-приложений: brew list --cask

Это удобный способ установить такие программы, как google-chrome, visual-studio-code, discord, spotify без посещения сайтов.

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

Вы успешно освоили Homebrew, если можете:

1. Установить популярный консольный инструмент (например, tree для отображения структуры папок) и увидеть его в списке: brew list.
2. Обновить этот инструмент до последней версии: brew upgrade tree.
3. Найти и установить через --cask простое GUI-приложение (например, brave-browser).
4. Выполнить brew doctor и получить сообщение Your system is ready to brew.

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

Проблема: "Permission denied" или "Operation not permitted" при установке

Причина: Установочный скрипт не получил прав на запись в целевую директорию (/usr/local или /opt/homebrew). Решение: Убедитесь, что вы вошли в систему под учетной записью администратора. Перезапустите установку. Если проблема persists, проверьте права на директорию:

sudo chown -R $(whoami) /opt/homebrew  # Для Apple Silicon
# или
sudo chown -R $(whoami) /usr/local    # Для Intel

Затем повторите установку.

Проблема: Команда brew не найдена после установки

Причина: Путь к Homebrew (/opt/homebrew/bin или /usr/local/bin) не добавлен в переменную PATH текущей оболочки. Решение: Выполните команды из Шага 2 заново. Убедитесь, что редактируете правильный файл профиля (~/.zprofile для Zsh, ~/.bash_profile для Bash). После добавления строки перезапустите терминал.

Проблема: brew update не работает или очень медленный

Причина: Проблемы с DNS или доступом к GitHub (где хостятся репозитории formulae). Также может помочь сброс кэша. Решение:

1. Проверьте доступ: ping -c 3 github.com.
2. При необходимости настройте DNS (например, на 8.8.8.8).
3. Принудительно сбросьте кэш и обновите:

   cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core"
   git fetch --unshallow  # Если репозиторий не был полным
   git reset --hard origin/master
   brew update
   

Проблема: Конфликт имён (формула и cask с одинаковым именем)

Причина: Некоторые имена существуют и как консольный пакет (формула), и как GUI-приложение (cask). Решение: Явно укажите тип:

brew install <имя_формулы>       # Для консольной утилиты
brew install --cask <имя_cask>   # Для приложения

Или используйте brew search <имя> чтобы увидеть оба варианта.

Проблема: Ошибка сборки (для формул из исходников)

Причина: Не хватает зависимостей (например, Xcode Command Line Tools) или конфликт версий библиотек. Решение: Сначала выполните brew doctor и следуйте его рекомендациям. Часто помогает переустановка Command Line Tools:

sudo rm -rf /Library/Developer/CommandLineTools
xcode-select --install

Затем попробуйте установить проблемный пакет снова. В крайнем случае ищите готовые бинарные версии (bottle) или используйте --build-from-source с флагом --verbose для детального лога ошибки.