AM
Linux 6 мин чтения

Как исправить ошибки Homebrew (Brew) на Ubuntu

Пошаговое руководство по исправлению типичных ошибок Homebrew (Linuxbrew) в Ubuntu: сообщения при загрузке, проблемы с обновлением, ошибки прав доступа и неработоспособность команд brew.

HomebrewLinuxbrewUbuntubrew updatebrew doctorошибки пакетного менеджера

Симптомы

  • При запуске Ubuntu появляется сообщение «Error found when loading /home/user/.profile: /bin/brew: No such file or directory»
  • Команда brew update выдаёт ошибку и завершается аварийно
  • Команда brew upgrade падает с ошибкой «homebrew-core is a shallow clone»
  • brew doctor выдаёт предупреждения об устаревших компонентах или неверных правах доступа
  • Команды brew не работают или выдают «command not found»

Возможные причины

  • Некорректная установка Linuxbrew, при которой в .profile или .bashrc были добавлены ссылки на несуществующий /bin/brew
  • Повреждённый или неполный Git-клон репозиториев homebrew-core/homebrew-cask (shallow clone)
  • Неверные права доступа к директории /usr/local или подкаталогам
  • Устаревшие компоненты (Xcode/CLT) или сторонние библиотеки, не установленные через Homebrew
  • Незавершённая переустановка Homebrew после сбоя

Пошаговое решение

1

Удалите некорректные записи из файлов конфигурации shell

Если при загрузке Ubuntu вы видите ошибку вроде «/bin/brew: No such file or directory», значит установщик Linuxbrew внёс в файлы ~/.profile и/или ~/.bashrc строки, ссылающиеся на несуществующий путь. Откройте эти файлы в текстовом редакторе (например, nano) и удалите все строки, содержащие ссылки на brew, такие как: • export PATH="/home/linuxbrew/.linuxbrew/bin:..." • export MANPATH="/home/linuxbrew/.linuxbrew/share/man:$MANPATH" • export INFOPATH="/home/linuxbrew/.linuxbrew/share/info:$INFOPATH" • eval $(/bin/brew shellenv) После сохранения файла перезагрузите компьютер или выполните source ~/.profile, чтобы ошибка исчезла.

Команда 
nano ~/.profile && nano ~/.bashrc
2

Полностью удалите Linuxbrew и установите заново

Если Homebrew установился частично или работает некорректно, лучше полностью удалить его и переустановить. Сначала удалите директорию Linuxbrew и очистите записи из конфигурационных файлов shell (шаг 1). Затем выполните чистую установку, предварительно установив необходимые зависимости.

Команда 
sudo apt-get install build-essential curl file git
sh -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
source ~/.bashrc
3

Выполните brew update дважды и brew doctor для диагностики

Согласно официальному руководству по устранению неполадок, перед любыми действиями с Homebrew необходимо выполнить brew update два раза подряд, а затем brew doctor. Команда brew update скачивает последние версии формул, а brew doctor проверяет конфигурацию системы и выдаёт предупреждения о возможных проблемах. Исправьте все замечания, которые покажет brew doctor — это самая частая причина ошибок.

Команда 
brew update
brew update
brew doctor
4

Исправьте ошибку shallow clone для homebrew-core и homebrew-cask

Если brew update или brew upgrade падают с ошибкой «homebrew-core is a shallow clone», это значит, что локальный Git-клон репозитория формул неполный. Выполните команду для полной загрузки истории репозитория. Если ошибка повторяется после первой попытки, попробуйте добавить флаг -v для подробного вывода — репозитории большие и загрузка может занять время. Если это не помогло, можно удалить повреждённый клон и склонировать заново.

Команда 
git -C "/usr/local/Homebrew/Library/Taps/homebrew/homebrew-core" fetch --unshallow
git -C "/usr/local/Homebrew/Library/Taps/homebrew/homebrew-cask" fetch --unshallow
5

Проверьте и восстановите права доступа к директории /usr/local

Если команды brew падают с ошибками, связанными с правами доступа, убедитесь, что ваш пользователь является владельцем необходимых подкаталогов. Выполните команду для восстановления прав на все ключевые директории. После этого снова запустите brew update и brew doctor.

Команда 
cd /usr/local && sudo chown -R $(whoami) bin etc include lib sbin share var opt Cellar Caskroom Frameworks
6

Соберите отладочную информацию для создания обращения

Если ни один из шагов не решил проблему, соберите диагностические данные. Если проблема связана с конкретной формулой, используйте brew gist-logs с именем формулы. Если проблема общая — загрузите вывод команд brew config и brew doctor. Эти данные понадобятся при создании обращения на GitHub.

Команда 
brew gist-logs <имя_формулы>
brew config
brew doctor

Введение

Homebrew (в Linux-версии известен как Linuxbrew) — это бесплатный менеджер пакетов с открытым исходным кодом, который значительно упрощает установку программного обеспечения на Linux-системы, включая Ubuntu. Он использует Ruby-скрипты (формулы) для сборки программ из исходников и поддерживает бинарные пакеты (bottles) для быстрой установки.

Однако при установке или обновлении Homebrew на Ubuntu могут возникать различные ошибки. Ниже рассмотрены самые частые из них и способы их решения.

Диагностика проблемы загрузки

При проблемах с загрузкойLinuxсначала检查 system logs. Выполните journalctl -xb для просмотра логов последней загрузки. Обратите внимание на строки с [FAILED] или [ERROR]. Проверьте, какие службы не запустились: systemctl —failed. Это покажет точную причину незагрузки.

Восстановление через Live USB

Если система не загружается вообще, загрузитесь с Live USB. Смонтируйте корневой раздел: sudo mount /dev/sdaX /mnt. Проверьте файловую систему: sudo fsck /dev/sdaX. Переустановите загрузчик: sudo grub-install —root-directory=/mnt /dev/sda. Это восстановит GRUB после неудачного обновления.

Проверка конфигурации

Проверьте конфигурационные файлы: /etc/fstab (монтирование разделов), /etc/default/grub (параметры ядра), /etc/systemd/system.conf (systemd). Убедитесь, что UUID разделов в fstab совпадают с реальными: sudo blkid. Неправильный UUID — частая причина незагрузки после обновления или замены диска.

Исправление через chroot

Если нужен доступ к системе для исправления: sudo mount /dev/sdaX /mnt, sudo mount —bind /dev /mnt/dev, sudo mount —bind /proc /mnt/proc, sudo chroot /mnt. Теперь вы внутри системы и можете исправлять конфигурацию, переустанавливать пакеты или обновлятьinitramfs: update-initramfs -u.

Откат обновления

Если проблема возникла после обновления ядра или пакетов, загрузитесь с предыдущего ядра в меню GRUB. Затем выполните: sudo apt install —reinstall linux-image-$(uname -r) или sudo dnf downgrade kernel. Для автоматического отката: sudo apt-mark hold имя-пакета — запретит обновление этого пакета.

Источники

  1. github.com — проверено 31.05.2026
  2. apple.stackexchange.com — проверено 31.05.2026
  3. stackoverflow.com — проверено 31.05.2026
  4. en.wikipedia.org — проверено 31.05.2026