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

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

Homebrew (или просто brew) — это менеджер пакетов для macOS, который упрощает установку, обновление и удалениеThousands open-source программ и библиотек. Вместо ручного скачивания .dmg-файлов, поиска зависимостей и настройки переменных среды вы используете одну команду:

brew install <имя_программы>

Этот гайд показывает, как правильно установить Homebrew с нуля на любой современной версии macOS (от Monterey до Sonoma) на процессорах как Intel, так и Apple Silicon (M1/M2/M3).

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

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

1. У вас есть учётная запись с правами администратора (возможность использовать sudo).
2. Установлены Xcode Command Line Tools. Homebrew предложит их установить автоматически, но если хотите сделать это заранее, выполните в Терминале:

   xcode-select --install
   

3. У вас стабильное подключение к интернету.

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

Шаг 1: Запустите официальный скрипт установки

Единственный и самый важный шаг. Никогда не устанавливайте Homebrew из ненадёжных источников. Используйте только официальный скрипт:

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

Что делает команда:

• curl -fsSL ... — скачивает скрипт установки с GitHub, следуя редиректам (-L), не показывая прогресс (-s), и failing silently на ошибках (-f).
• $(...) — выполняет скачанный скрипт в текущей оболочке.
• /bin/bash -c — явно запускает скрипт в bash, даже если ваш терминал по умолчанию использует zsh (актуально для macOS Catalina+).

Шаг 2: Введите пароль администратора

После запуска скрипта система запросит ваш пароль. Вводите его всё с маленькой буквы, символы не будут отображаться (даже звёздочки) — это особенность безопасности macOS. Просто введите пароль и нажмите Enter.

Шаг 3: Дождитесь завершения установки

Скрипт выполнит следующие действия:

1. Проверит наличие Xcode Command Line Tools и установит их при необходимости (может потребоваться отдельно нажать «Установить» в всплывающем окне).
2. Создадит нужные директории (/usr/local для Intel или /opt/homebrew для Apple Silicon).
3. Скачает и распакует последнюю стабильную версию Homebrew.
4. Настроит переменные среды в вашем профиле оболочки (.zprofile для zsh, .bash_profile для bash).

Не прерывайте процесс! На это может уйти до 10 минут, особенно при первом запуске Xcode Tools.

Шаг 4: Активируйте Homebrew в текущем сеансе

После завершения установки скрипт выведет инструкции. Чтобы команда brew стала доступна сразу в текущем открытом окне Терминала, выполните:

• Для macOS на Apple Silicon (M1/M2/M3):

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

• Для macOS на Intel:

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

Либо просто закройте и снова откройте Терминал — изменения вступят в силу автоматически.

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

Убедитесь, что установка прошла успешно:

1. Проверьте версию:

   brew --version
   

   
   Вывод должен быть примерно таким: Homebrew 4.x.x.
2. Запустите диагностику:

   brew doctor
   

   
   Идеальный результат: Your system is ready to brew. Если есть предупреждения — следуйте их советам.
3. Попробуйте установить простую утилиту (например, wget):

   brew install wget
   

   
   После успешной установки выполните wget --version.

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

Ошибка: Permission denied или Operation not permitted

Причина: Терминал запущен без прав администратора, или скрипт не может записать в целевую директорию. Решение: Убедитесь, что вы вводили пароль при запросе. Если проблема осталась, попробуйте запустить скрипт с sudo (хотя официальная инструкция этого не требует):

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

Ошибка: Command Line Tools already installed

Причина: Xcode Command Tools уже присутствуют, но их путь не настроен. Решение: Выполните sudo xcode-select --reset или укажите путь явно: sudo xcode-select -s /Library/Developer/CommandLineTools.

Ошибка: brew: command not found после установки

Причина: Переменная PATH не обновлена в текущем сеансе. Решение: Следуйте шагу 4 выше (активация через eval) или перезапустите Терминал.

Медленная установка или обрывы

Причина: Проблемы с сетью или GitHub. Решение: Установите Homebrew через国内的镜像（如清华源）или используйте VPN. Для смены репозитория выполните:

cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core"
git remote set-url origin https://mirror.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git

Часто задаваемые вопросы (FAQ)

Можно ли удалить Homebrew? Да. Для полного удаления выполните официальный скрипт удаления:

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

Затем вручную удалите остаточные файлы: rm -rf ~/.brew (если был) и строки из .zprofile/.bash_profile.

Как обновлять Homebrew и установленные пакеты? Обновляйте Homebrew: brew update. Обновляйте все пакеты: brew upgrade. Для очистки старых версий: brew cleanup.

Что такое Formulae и Casks?

• Formulae — пакеты с консольными утилитами и библиотеками (например, python, git).
• Casks — пакеты с GUI-приложениями в формате .dmg/.pkg (например, firefox, visual-studio-code). Устанавливаются командой brew install --cask <имя>.

Можно ли использовать Homebrew вместе с MacPorts или Fink?Нет. Эти менеджеры пакетов конфликтуют, так как используют одинаковые пути. Выберите один. Homebrew — самый популярный и рекомендуемый для большинства пользователей.