症状：Homebrewを入れたのに「brew: command not found」と表示される。
最短の確認方法：インストールが完了したかを見てから、ターミナルのShellとPATHを調べます。
この順番なら、Homebrewの再インストールや危険な権限変更を急がずに原因を絞れます。特に、コマンドが一時的に使えるのにターミナルを開き直すと使えなくなる場合は、Shellの起動時設定を確認してください。
MacでHomebrewを入れたばかりの学生や、Python・フロントエンドの講座に沿って開発ツールを準備している人向けです。
リモートMacで同じエラーが出ていて、Mac環境とターミナル設定のどちらを見直すべきか迷っている場合にも役立ちます。
まず「インストール未完了」と「コマンドが見つからない」を分けます
brewが使えない原因は、Homebrewのインストール自体が終わっていない場合と、インストール済みでもターミナルが実行ファイルの場所を探せない場合に分かれます。コマンドを実行できても、その後の操作でエラーになるなら、別の問題として調べます。
最初に、直前に実行した操作と表示されたエラー全文をメモしてください。「command not found」と、権限や開発用ツールについてのエラーでは、確認先が違います。
Homebrew公式のインストール案内では、インストール後にShellの設定を行う手順も説明されています。最後まで処理が終わったかを確認し、表示された案内を飛ばしていないか見直しましょう。
「動かなかったからもう一度インストールする」と決める前に、エラー全文を残してください。同じコマンドを繰り返すだけでは、設定の問題が直らないことがあります。
brewが見つからないときは、ShellとPATHをどう調べる？
Shellは、ターミナルで入力した命令を受け取り、実行するための窓口です。PATHは、Shellがコマンドを探しに行く場所を並べた「探し物リスト」のようなものです。Homebrewが入っていても、その場所がリストにないとbrewを見つけられません。
第一歩：今のShellとコマンドの場所を確認する
ターミナルで次を実行します。
echo $SHELL
command -v brewecho $SHELLはログイン時に使うShellの確認、command -v brewは現在の環境からbrewを呼び出せるかの確認です。後者に何も表示されない場合は、インストールが終わっていないか、PATHにHomebrewの場所が含まれていない可能性があります。
Homebrew公式のインストール後の設定には、Macの構成に応じたbrew shellenvの使い方が記載されています。Apple Silicon向けとIntel向けで例示される場所は同じとは限らないため、他のMacで見たパスをそのままコピーせず、公式案内と自分のインストール時の表示を照合してください。
| 確認した状態 | 次にすること | 避けること |
|---|---|---|
| インストール中にエラーが出た、または完了表示を確認できない | エラー全文を残し、公式のインストール案内と照合する | 何度も同じインストールを繰り返す |
インストールは完了したがcommand -v brewに結果が出ない |
現在のShellとPATH、インストール後の設定を確認する | 別のMacのパスを根拠なく追加する |
| ターミナルでは見つかるがVS Codeでは見つからない | VS Code側のShellと起動環境を確認する | 複数の設定ファイルへ同じ設定を重ねる |
| brewは見つかるが実行時に権限などのエラーが出る | エラーの種類に応じて公式の排錯案内を確認する | PATHの問題と決めつけて権限を変更する |
ターミナルを開き直すと使えない場合は、起動設定を確認します
設定を実行した直後だけbrewが使えるなら、その設定が現在のターミナル内だけで有効になっている可能性があります。ターミナルを起動したときに読み込まれるファイルに設定が保存されているかを確かめましょう。
たとえばzshを使っている場合、Homebrew公式案内はbrew shellenvを使った設定方法を示しています。案内に記載されたコマンドと設定先を確認し、ほかのShellや別のMac向けの設定を混ぜないでください。設定ファイルは、Shell起動時に開く「準備ノート」のようなものです。
変更後はターミナルを開き直し、もう一度command -v brewを実行します。設定をその場で読み込み直す場合は、対象のファイルやコマンドを公式案内で確認してから行ってください。設定先を間違えたまま同じ行を複数のファイルに足すと、次に原因を調べるときにどの設定が使われているのか分かりにくくなります。
VS Codeだけで見つからないなら、別のターミナル環境を疑います
システムのターミナルではbrewが使えるのに、VS Code内のターミナルで使えない場合、Homebrewをすぐに入れ直す必要はありません。VS Codeが起動した経路や選択中のターミナルプロファイルによって、読み込まれるShellや環境設定が異なることがあります。
VS Codeのターミナルプロファイル設定とターミナル環境の説明を参照し、VS Code内で次の点を比べます。
- システムのターミナルと同じShellを選んでいるか
- VS Code内で
echo $SHELLとcommand -v brewを実行した結果 - ターミナルを開き直した後も結果が変わらないか
VS CodeのShell連携については公式の説明も確認できます。設定ファイルを一律に増やすより、どの環境で違いが出ているかを先に特定してください。
症状に合わせて、次の確認先を選びます
- インストール完了を確認できない場合：エラーの記録を残し、Homebrewのインストール案内に沿って状況を見直します。
- システムのターミナルでも
brewが見つからない場合：ShellとPATHを確認し、インストール後の設定を照合します。 - ターミナルを開き直すと使えない場合：使っているShellの起動設定を確認し、設定を読み込み直してから再確認します。
- VS Codeだけで使えない場合：VS Code内のShellと環境設定を、システムのターミナルと比べます。
- 権限や依存ツールのエラーが出る場合：PATHの修正は止めて、エラーの種類に応じて公式の排錯ガイドを確認します。
Homebrew公式のFAQとbrewコマンドの説明も、コマンドが見つからない問題と、見つかった後の実行エラーを分けるときに参照できます。
エラーを消す目的だけで、
sudoを使った保護対象ディレクトリの変更、再帰的な権限変更、出どころの分からないスクリプトの実行はしないでください。何を変えたのか追えなくなり、別の不具合につながるおそれがあります。
よくある疑問
Homebrewを入れたのにbrewが見つからないのはなぜですか？
インストール未完了か、PATHに実行ファイルの場所が入っていない可能性があります。インストール時の表示を確認したうえで、command -v brewとShellの設定を調べてください。
ターミナルを開き直すと使えなくなる場合、何を見直せばよいですか？
一時的な設定だけが有効になっていないかを確認し、使用中のShellに合った起動設定を見直します。公式案内に沿って設定した後、新しいターミナルで再確認してください。
VS Codeでだけ使えない場合、Homebrewを入れ直すべきですか？
まずVS Code内のShellとcommand -v brewの結果を、システムのターミナルと比べます。環境設定の違いが原因なら、Homebrewの再インストールでは解決しません。
見つからないエラーが出るたびに、再インストールしたほうがよいですか？
いいえ。インストールの完了、PATH、VS Codeとの環境差、権限エラーを切り分けてから判断してください。解決しない場合は、Shell名とエラー全文、実施した確認内容をまとめて公式の排錯資料を参照します。
コースの課題で、修復できたかを確かめます
設定の変更だけで終わらせず、学習に使うターミナルで確認します。ターミナルを開き直したうえで、次の項目をチェックしてください。
- [ ]
command -v brewで、実行できるコマンドの場所が表示される - [ ]
brew --versionが実行できる - [ ] ターミナルを開き直しても、同じ確認ができる
- [ ] VS Codeで作業するなら、VS Code内のターミナルでもコマンドを確認する
- [ ] 講座でHomebrewから入れたツールを使う場合、そのツールの確認コマンドも実行する
Homebrewの確認が通っても、コースで使うツールやプロジェクトまで動くとは限りません。課題で指定されたコマンドを小さな練習用プロジェクトで試し、追加のエラーが出たらHomebrewの問題と決めつけず、そのエラーを別に記録しましょう。
ローカルMacで直せないとき、環境を変えるべきでしょうか？
学校のPCでソフトウェアの導入が制限されている、自分のPCがMacではない、手元に使えるMacがない場合は、設定修正だけでは解決できないことがあります。Homebrewは対応するmacOSまたはLinux環境が前提となるため、使えない環境でコマンドだけを無理に動かそうとせず、Homebrew公式の対応環境に関するFAQを確認してください。
一方、Macは使えるのにPATH設定だけが原因なら、端末を借り換えるより、公式手順でShell設定を直すほうが先です。Macの開発環境全体を整える必要がある場合は、Macでの開発用途やPython開発環境の準備に関する案内を確認し、授業で指定された環境と合うかを見比べてください。
WindowsのままではMac専用の開発ツールを直接使えないことがあり、学校の共用PCでは設定を保存できない場合もあります。リモートMacなら手元のMac購入を避けられる一方、接続環境に左右され、継続利用にはレンタル費用もかかります。授業でMacが必要なのに手元の環境を用意できない場合に限り、KVMFLUXの利用料金を確認し、課題期間や必要な作業に合うかを比べてください。