macOSで「brew: command not found」エラーを解決する方法 – Homebrewパス設定のクイック修正ガイド

当サイトにはアフィリエイトリンクが含まれています。Amazonアソシエイトとして、適格な購入から手数料をいただく場合があります（追加料金は発生しません）。

Macで「brew: command not found」というエラーに遭遇した場合、ターミナルでの簡単なパス修正だけで問題を解決できることがあります。

このよくあるトラブルは、Homebrewを使ってソフトウェアパッケージを管理しようとしている多くのmacOSユーザーを悩ませています。

このエラーの根本的な原因は、Homebrewのインストールが正しく行われていないこと、$PATH環境変数の設定が崩れていること、そして場合によってはシステムアップデートによって環境が変化してしまったことに起因することがほとんどです。

このガイドでは、迷うことなく問題に取り組めるよう、簡単に実践できる解決策を順を追ってご紹介します。

Macで「brew: command not found」エラーが発生する理由

Macで「brew: command not found」エラーが表示されるのは、通常、macOS向けの人気パッケージマネージャーであるHomebrewに不可欠なbrewコマンドをシステムが見つけられない場合です。

このエラーが発生する主な原因は以下の通りです。

1. インストールが正しく行われていない：Homebrewが正しくインストールされていない場合、システムはbrewコマンドを認識できません。不完全または破損したインストールがこの問題につながることがあります。
2. パスの問題：Homebrewのバイナリがシステムの$PATH環境変数に含まれていない場合、brewコマンドは動作しません。この変数はシステムが実行ファイルの場所を特定するために使われるもので、設定が誤っているとbrewコマンドを見つけられなくなります。
3. デフォルトの環境設定が変更されている：シェルをカスタマイズしていたり、.zshrcや.bashrcファイルに大きな変更を加えていたりすると、デフォルト環境が変わり、システムがbrewコマンドを見つけられなくなることがあります。
4. Zshコマンドの入力ミス：Zshをシェルとして使用している場合、コマンドのスペルミスや構文エラーがあると、「brew: command not found」エラーが発生することがあります。コマンドライン入力にタイポがないか必ず確認しましょう。
5. パッケージがインストールされていない：意外に思われるかもしれませんが、そもそもHomebrewがマシンにインストールされていないだけというケースもあります。プリインストールされていると思い込んでいる場合は（実際にはされていません）、まずダウンロードしてインストールする必要があります。
6. システムアップデート：macOSのアップデートによって環境設定やファイルの場所が変わることがあり、その結果このエラーが発生する場合があります。最近のアップデートでシステム設定が変更され、brewコマンドが認識されなくなった可能性もあります。
7. アクセス権限：場合によっては、Homebrew関連のディレクトリやファイルへのアクセス権限が不十分なためにこの問題が起こることがあります。これは複数ユーザーが同じシステムを使用している場合や、あるMacから別のMacへデータを移行した後によく発生します。

「brew: command not found」エラーの根本原因を理解することが、解決への第一歩です。原因がわかれば、適切なトラブルシューティングの手順に従って問題を修正できます。

Macの「Brew: Command Not Found」エラーの修正方法：クイック回答

Macで「brew: command not found」エラーを最も早く修正する方法は、Homebrewが正しくインストールされているかどうかを確認することです。ターミナルを開いて which brew と入力してください。何も表示されなければ、Homebrewがインストールされていないことを意味します。以下のコマンドを実行すれば簡単にインストールできます。

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

最速の解決策をご紹介したところで、次にこの問題の背景にある理由を掘り下げ、他のトラブルシューティング方法も確認していきましょう。

Macで「brew: command not found」エラーを修正する前に、問題の根本原因を理解することが重要です。

その土台があれば、さまざまなシナリオに応じた複数の解決策を使って、体系的に問題に取り組むことができます。それでは、この厄介なエラーを完全に排除していきましょう。

修正1：構文を確認する

信じられないかもしれませんが、単純なタイポや構文エラーが、あの厄介な「brew: command not found」メッセージの原因であることがあります。

構文エラーは些細なことに見えますが、プロセス全体を台無しにするには十分です。コマンド入力のミスはよくあることで、より複雑なトラブルシューティングに進む前に、必ず構文を再確認する習慣をつけましょう。

以下の手順で確認します。

1. Spotlight検索からターミナルアプリを起動します。

1. コマンドを入力し、タイポ、余分なスペース、欠けている文字がないか慎重に確認します。brew と正しく入力しているか、breqやbrewsのような入力になっていないか確かめましょう。
2. 複雑なコマンドの場合は、公式のHomebrewドキュメントを参照するか、brew helpと入力してコマンドラインヘルプを確認し、構文が正しいかチェックします。
3. 構文に自信が持てたら、修正したコマンドを実行します。

修正2：Zsh用のBrewを再インストールする

Zshを使用していて「brew: command not found」エラーに遭遇した場合、最も簡単な解決策の一つは、Zsh向けにHomebrewを再インストールすることです。

初期のインストールがZshとうまく統合されていなかったり、別のシェルからZshに切り替えたことで互換性の問題が生じていたりすることがあります。

この修正は、Zshをデフォルトシェルとして使用しているユーザーに特に有効ですが、Bashなど他のシェルのユーザーにも応用できます。

Zsh用のBrewを再インストールする手順は以下の通りです。

1. クリーンな状態から始めるため、既存のHomebrewインストールをアンインストールすることをおすすめします。
2. Homebrewをアンインストールするには、ターミナルを開いて以下のコマンドを実行し、Enterキーを押します。

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

1. アンインストールが完了したら、以下のコマンドで確認できます。

which brew

1. 何も返ってこなければ、アンインストールは成功しています。
2. 次に、新しいZshターミナルウィンドウを開き、Homebrewのインストールスクリプトを実行します。

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

1. これにより最新版のHomebrewがセットアップされます。ターミナルを閉じて再度開いた後は、brew コマンドを問題なく使用できるはずです。

修正3：BrewをPATH変数に追加する

Homebrewをインストール済みなのに「brew: command not found」エラーが出続ける場合、HomebrewのディレクトリがシステムのPATH変数に含まれていないことが原因かもしれません。コンピュータはPATH変数を使って、ターミナルに入力されたコマンドをどこから探すべきかを判断しています。

通常、Homebrewはセットアップ時に自動的にインストールディレクトリをシステムのPATHに追加します。しかし、何らかの理由でそれが行われず、このエラーメッセージが表示されることがあります。

以下の手順で、brewをPATH変数に手動で追加できます。

Bashユーザーの場合：

次のコマンドでディレクトリをPATHに手動追加できます。

echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bash_profile

なお、/usr/local/binは、Homebrewが実際にインストールされているディレクトリに置き換える必要がある場合があります。例えば、一部のmacOSシステムでは/opt/homebrew/bin配下にインストールされます。

Zshユーザーの場合：

同様のコマンドを使用します。

echo 'export PATH="/usr/local/bin:$PATH"' >> $HOME/.zshrc

変更を確認するには、以下を実行します。

brew --version

Homebrewのバージョンが表示されれば、PATHの更新は成功です。

設定を整理しておくためにも、Homebrewのインストールディレクトリを.zshrcファイルに追加しておくのが一般的におすすめです。

1. nano ~/.zshrcコマンドで.zshrcファイルを開きます。

1. 次の行を追加します：export PATH="$PATH:/opt/homebrew/bin"

1. Command + Xを押し、その後Enterキーを押してファイルを保存します。

1. source ~/.zshrcを実行して変更を反映させます。

これにより、新しく開くすべてのターミナルセッションでHomebrewにアクセスできるようになります。

HomebrewをPATHに追加することで、コンピュータにbrewコマンドの場所を教えることになります。これは多くのユーザーに効果のある一般的な修正方法です。まだ問題が解決しない場合は、他の解決策に進みましょう。

修正4：M1 MacにARM版をインストールする

M1 Macを使用していて「brew: command not found」の問題が発生している場合、M1アーキテクチャ向けに設計されたARM版のHomebrewをインストールする必要があるかもしれません。

M1 MacはIntel Macとは異なるチップアーキテクチャを採用しており、適切なバージョンのHomebrewをインストールすることで大きな違いが生まれます。

M1 MacにARM版をインストールする手順は以下の通りです。

1. M1 Macでターミナルアプリを開きます。
2. cd ~ と入力してEnterキーを押し、ホームディレクトリにいることを確認します。

1. ARM専用版のHomebrewをインストールするには、以下のコマンドを入力してEnterキーを押します。

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

1. これにより、ARM互換版のHomebrewが自動的にインストールされます。
2. 必要に応じて、以下を入力してEnterキーを押し、Homebrewのバイナリの場所をPATH環境変数に追加します。

echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc

1. 以下を実行して、すぐに変更を反映させます。

source ~/.zshrc

1. 新しいターミナルウィンドウを開いてbrew --versionと入力し、インストールを確認します。バージョン番号が表示されれば、ARM版Homebrewのインストールは成功です。

これらの手順に従えば、M1 Macのアーキテクチャに最適化された正しいバージョンのHomebrewが動作していることを確認できます。

修正5：MacにXcodeをインストールする

場合によっては、Macに特定の開発者ツールが存在しないことが「brew: command not found」エラーの原因となることがあります。その代表的なものがXcodeです。Xcodeにはコマンドラインツールが付属しており、これらはHomebrewやその他多くのパッケージの前提条件となることがよくあります。

MacにXcodeをインストールする手順は以下の通りです。

1. アプリケーションフォルダまたはSpotlight検索からターミナルアプリを起動します。

1. 以下のコマンドを入力してEnterキーを押します。

xcode-select --install

1. インストールの確認を求めるポップアップウィンドウが表示されます。インストールをクリックして続行します。

1. 画面の指示に従ってインストールを完了します。これにより、macOSに必要なコマンドライン開発者ツールがダウンロード・インストールされます。
2. インストールが完了したら、以下のコマンドで確認できます。

xcode-select -p

1. /Applications/Xcode.app/Contents/Developerのようなパスが返ってくれば、インストールは成功しています。

Xcodeとそのコマンドラインツールをインストールすることで、「brew: command not found」エラーの根本的な問題を解消できることがあります。Xcodeは他の多くのパッケージにとっても基盤となるツールなので、Macで開発作業を行う予定がある方には特に有用な修正方法です。

作業完了後にXcodeをアンインストールしたい場合は、こちらの記事の手順を参照してください。

修正6：Homebrewのインストールを修正する

それでも「brew: command not found」の問題が解決しない場合は、Homebrewのインストール自体を修正するのが良いでしょう。不完全または破損したインストールが原因であることが多いからです。

以下の手順でHomebrewのインストールを修正します。

1. Macでターミナルアプリを開きます。
2. ターミナルで以下を入力し、Enterキーを押します。

export PATH="/opt/homebrew/bin:$PATH"

1. 再起動後もこの変更を維持するには、以下のコマンドを入力してEnterキーを押します。

echo 'export PATH="/opt/homebrew/bin:$PATH"' >> $HOME/.zshrc

これらのコマンドを実行してもターミナルからのフィードバックはありませんが、それは正常な動作です。

すべてが正しく設定されているか確認するには、brew helpと入力します。Homebrewのコマンド一覧が表示されれば、インストールの修正は成功です。

修正7：キャッシュをクリアする

時には、キャッシュの蓄積がHomebrewの動作を妨げ、あの忌々しい「brew: command not found」エラーにつながることがあります。キャッシュをクリアすることで、古いファイルや破損したファイルに関連する問題を解決できます。

MacでHomebrewのキャッシュをクリアする手順は以下の通りです。

1. アプリケーションフォルダまたはSpotlight検索からターミナルアプリを開きます。
2. 以下のコマンドを入力してEnterキーを押します。

hash -r

警告：このコマンドはすべてのキャッシュファイルを削除します。実行前に正しいディレクトリにいることを確認してください。

1. エラーが発生する場合は、Homebrewが正しくインストールまたは認識されていない可能性があります。

よくある質問

MacのZshシェルとは何ですか？

MacのZshシェルは、ユーザー向けのコマンドラインインターフェースとして機能する高度な対話型シェルです。macOS Catalina以降にプリインストールされており、Bashに代わってデフォルトシェルとなっています。Zshは自動補完、強化されたスクリプト機能、豊富なカスタマイズオプションといった強力な機能を備えており、開発者の間で人気があります。

Macのbrewコマンドとは何ですか？

Macのbrewコマンドは、macOS向けに特別に設計された無料のオープンソースパッケージマネージャーであるHomebrewを指します。コマンドラインから直接ソフトウェアパッケージを簡単にインストール、更新、管理できます。Homebrewは、開発者ツールやライブラリ、さらにはMac App Storeでは入手できない一部のアプリケーションのインストールにも広く使われています。

「brew command not found」とは何ですか？

「brew: command not found」エラーは、コマンドライン経由でソフトウェアをインストールする際に一般的に使用されるHomebrewパッケージマネージャーをシステムが見つけられないときにMacで発生します。この問題は、インストールの不具合、PATH変数の欠落、その他のシステムレベルの不整合によって引き起こされることがあります。

BrewはMacにとって安全ですか？

はい、HomebrewはMacにとって安全だと広く認識されています。大規模な開発者コミュニティによって検証されてきたオープンソースのパッケージマネージャーです。Homebrewはチェックサムを使用してダウンロードしたパッケージの整合性を検証し、ソフトウェアのインストール、更新、管理のための安全な手段を提供するため、macOSユーザーにとって信頼できるツールです。

Macでbrewのパスを設定するにはどうすればよいですか？

MacでHomebrewのパスを設定するには、通常、シェルのPATH環境変数を更新します。Zshの場合は.zshrcなどのシェルプロファイルファイルにexport PATH="$PATH:/opt/homebrew/bin"を追加します。その後、source ~/.zshrcを実行して変更を反映させます。これにより、ターミナルでbrew コマンドが認識されるようになります。

まとめ

Macで「brew: command not found」エラーを解決することは、決して難しい作業ではありません。このガイドで紹介した修正方法を使えば、単純な構文エラーからより複雑な設定問題まで、原因に応じて体系的にトラブルシューティングと解決が可能です。それぞれの解決策が異なる潜在的な原因に対応しているため、Homebrewを素早く復旧できる可能性が高まります。プロのヒント：brew updateとbrew upgrade を定期的に実行してHomebrewのインストールを最新の状態に保つことで、最適なパフォーマンスを維持し、エラーを減らすことができます。

Mohitについて