はじめに
Homebrewは、MacOSで使える便利なパッケージマネージャですが、導入時や利用中に「brew command not found」というエラーが発生することがあります。このエラーは、Homebrewのインストールが正しく完了していないか、環境変数の設定が適切でない場合に起こります。本記事では、具体的な原因と解決策について解説します。
発生するエラーの詳細
ターミナルでbrewコマンドを実行した際に、以下のようなエラーが表示されることがあります。
$ brew --version
zsh: command not found: brew
エラーの意味
- command not found: ターミナルが
brewコマンドを見つけることができない状態です。 - 原因: Homebrewが正しくインストールされていない、またはシェルの環境変数にパスが設定されていない可能性があります。
解決方法
以下の手順を順に試すことで、多くの場合、このエラーを解消できます。
1. Homebrewのインストールを確認する
まず、Homebrewが正しくインストールされているか確認します。以下のコマンドを実行してください。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
このコマンドは、公式のインストーラーを利用してHomebrewを再インストールまたはアップデートします。
2. 環境変数にPATHを設定する
brewコマンドが認識されない場合、Homebrewのインストールパスがシェルの環境変数PATHに追加されていない可能性があります。以下の手順で修正します。
現在のシェルを確認
以下のコマンドで、現在使用しているシェルを確認します。
echo $SHELL
結果として/bin/zsh（Zsh）や/bin/bash（Bash）などが表示されます。
Zshの場合（MacOS Catalina以降のデフォルト）
~/.zshrcファイルを編集します。
nano ~/.zshrc
ファイルの末尾に以下を追加します。
export PATH=/opt/homebrew/bin:$PATH
変更を保存したら、設定を反映させます。
source ~/.zshrc
Bashの場合
~/.bash_profileまたは~/.bashrcファイルを編集します。
nano ~/.bash_profile
同様に以下を追加します。
export PATH=/opt/homebrew/bin:$PATH
保存後、設定を反映させます。
source ~/.bash_profile
3. Homebrewのインストール先を確認する
Macのチップ（IntelまたはApple Silicon）によって、Homebrewのデフォルトのインストールパスが異なる場合があります。
Apple Siliconの場合
Homebrewは通常、/opt/homebrewディレクトリにインストールされます。以下のコマンドで確認できます。
ls /opt/homebrew
Intel Macの場合
Intel Macでは、Homebrewは/usr/local/binにインストールされます。以下のコマンドを実行して確認してください。
ls /usr/local/bin/brew
4. brewコマンドを再度確認する
PATHが正しく設定されたら、brewコマンドが動作するか確認します。以下を実行してください。
brew --version
例:
$ brew --version
Homebrew 3.5.10
正しいバージョンが表示されれば、エラーは解消されています。
5. ターミナルの再起動
変更後にエラーが解消されない場合、ターミナルを一度閉じて再起動してください。この操作で設定が再読み込みされることがあります。
他の可能性と対応策
Homebrewが壊れている場合
Homebrewが壊れている場合、以下のコマンドで修復を試みてください。
brew doctor
このコマンドはHomebrewの問題を診断し、修復方法を提案してくれます。
完全な再インストール
他の方法でも解決しない場合、Homebrewを完全に再インストールすることが必要です。以下を実行して削除します。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
その後、インストール手順に従って再インストールしてください。
まとめ
MacでのHomebrew利用時に発生する「brew command not found」エラーの解決方法を説明しました。以下をチェックリストとして活用してください。
- Homebrewが正しくインストールされているか確認する。
- 環境変数
PATHを正しく設定する。 - インストール先を確認し、チップに合わせたパスを利用する。
- 再インストールや
brew doctorで修復を試みる。
これらの手順を実行することで、多くの場合エラーを解決できます。Macで快適な開発環境を構築する第一歩として、ぜひお試しください。
