Установка Homebrew на macOS: полное руководство для новичков

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

Homebrew (или просто brew) — это незаменимый менеджер пакетов для macOS, который упрощает установку, обновление и удаление тысяч бесплатных утилит, библиотек и программ, отсутствующих в официальном App Store. После установки вы сможете устанавливать такие инструменты, как git, python, node, wget, ffmpeg и многие другие, одной командой. Это стандарт де-факто для разработчиков и системных администраторов на Mac.

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

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

1. У вас есть Mac с macOS 10.14 (Mojave) или новее.
2. У вас есть доступ к учётной записи с правами администратора (для ввода пароля при установке).
3. У вас установлен Xcode Command Line Tools. Если нет, первый шаг руководства поможет вам это сделать.
4. У вас есть стабильное подключение к интернету.

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

Шаг 1: Проверьте наличие Xcode Command Line Tools

Homebrew напрямую зависит от этих инструментов. Откройте Терминал (через Spotlight Cmd+Пробел -> "Терминал" или в /Программы/Утилиты/) и выполните команду:

xcode-select --install

Если инструменты уже установлены, система сообщит об этом. Если нет, появится диалоговое окно — нажмите "Установить" и следуйте инструкциям. Установка займет несколько минут.

Шаг 2: Скачайте и запустите официальный установочный скрипт

В том же окне Терминала выполните команду для загрузки и запуска скрипта установки:

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

⚠️ Важно: Всегда проверяйте URL скрипта. Официальный репозиторий Homebrew — github.com/Homebrew/install.

Скрипт подробно расскажет, что будет делать, и запросит ваш пароль (символы не отображаются при вводе — это нормально). Нажмите Enter после ввода. Дождитесь завершения установки.

Шаг 3: Настройте переменную окружения PATH

После установки скрипт выведет инструкции по добавлению Homebrew в вашу PATH (переменную, которая определяет, где система ищет исполняемые файлы). Это критически важный шаг.

1. Определите архитектуру вашего Mac:
   • Apple Silicon (M1, M2, M3 и новее): Homebrew устанавливается в /opt/homebrew.
   • Intel: Homebrew устанавливается в /usr/local.
2. Откройте файл конфигурации вашей оболочки. Для standard macOS (Zsh, начиная с Catalina) это ~/.zprofile:

   nano ~/.zprofile
   

   
   Или для старых версий с Bash: nano ~/.bash_profile.
3. Добавьте в конец файла одну из следующих строк (в зависимости от архитектуры):
   • Для Apple Silicon:

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

   • Для Intel:

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

4. Сохраните (Ctrl+O, Enter) и закройте редактор (Ctrl+X).
5. Примените изменения к текущей сессии Терминала:

   source ~/.zprofile  # или source ~/.bash_profile
   

Шаг 4: Проверьте успешность установки

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

brew doctor

Эта команда проанализирует вашу систему. В идеальном случае вы увидите Your system is ready to brew.. Если есть предупреждения, внимательно прочитайте их — brew doctor часто предлагает конкретные решения.

brew --version

Эта команда покажет установленную версию Homebrew (например, Homebrew 4.2.0). Если команда brew не найдена, вернитесь к Шагу 3 и перепроверьте настройку PATH.

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

Успешная установка подтверждается:

1. Команды brew --version и brew doctor работают без ошибок.
2. Вы можете установить простое приложение. Например, установите утилиту wget:

   brew install wget
   

   После завершения попробуйте запустить wget --version.

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

• Ошибка Permission denied при запуске установочного скрипта.
  • Причина: У вас нет прав на запись в системные директории.
  • Решение: Убедитесь, что вы работаете от своей основной учётной записи (не через root или гостевую). Не используйте sudo для установки Homebrew. Если проблема persists, проверьте права на целевую папку (/usr/local или /opt/homebrew).
• Команда brew не найдена после установки.
  • Причина: PATH не настроен правильно.
  • Решение: Внимательно повторите Шаг 3. Убедитесь, что вы добавили строку в правильный конфигурационный файл (~/.zprofile для Zsh) и применили изменения командой source.
• Ошибка Command Line Tools are already installed, but they are not configured. от xcode-select.
  • Причина: Инструменты установлены, но путь к ним не указан.
  • Решение: Выполните команду sudo xcode-select --reset или укажите путь явно: sudo xcode-select -s /Library/Developer/CommandLineTools.
• Ошибки при скачивании (curl: (7) Failed to connect).
  • Причина: Проблемы с сетевым подключением или блокировка со стороны корпоративного фаервола/прокси.
  • Решение: Проверьте интернет-соединение. Если вы в корпоративной сети, возможно, потребуется настроить прокси для curl или использовать альтернативный метод установки.