Apple silicon MacのHomebrew既定インストール先は/opt/homebrew、Intel Macでは/usr/localです(Homebrew公式FAQの既定パス)。
症状:Homebrewをインストールしたのに、ターミナルでbrewが見つからない。
最短の対処:まずインストールが完了したか確認し、実際の配置先とshell設定を調べてください。brewのファイルがあるのに新しいターミナルで使えない場合は、Homebrew公式の案内に沿って設定を直します。すぐ再インストールしたり、システム権限を変更したりする必要はありません。
初めてMacにHomebrewを入れ、コマンドが認識されず困っている学生向けです。
WindowsからMacに移り、授業用の開発ツールを準備している人も、順番に確認できます。
学校管理のMacや遠隔Macを使う場合は、設定を変える前に端末の管理ルールも確かめてください。
インストール直後に、完了したかを確認する
Homebrewを入れたのにbrewが見つからない場合は、「インストールが途中で止まった」のか、「インストール済みだがターミナルが場所を認識していない」のかを切り分けます。エラーが出たら、表示を省略せずに控えてください。インストール時に表示された最後のメッセージも手掛かりになります。
最初にターミナルでcommand -v brewを実行し、brewの場所が表示されるか確認します。場所が表示されたらbrew --versionを実行してください。コマンドとバージョン確認の使い方は、Homebrew公式のコマンドマニュアルで確認できます。
何も返らなくても、Homebrewがインストールされていないとは限りません。command -vは、ターミナルがコマンドを探す場所の一覧(PATH)からbrewを見つけられなかったことを示すだけです。ソフト自体の有無を、次に確かめます。
インストールが途中で止まったように見える場合は、最後のエラーを確認してください。原因が分からないままインストールを繰り返すと、どこで失敗したかを判断しにくくなります。
既定パスと実際の配置先を照合する
Homebrewの既定のインストール先はMacのチップ構成で異なります。公式FAQでは、Apple silicon向けの既定パスを/opt/homebrew、Intel Mac向けを/usr/localと案内しています(Homebrew公式FAQ)。ただし、これは既定値です。カスタム設定や学校独自の構成がある端末では、実際の場所が異なる場合があります。
インストール時に表示された場所が分かるなら、その情報を優先してください。場所が不明なら、該当する既定パスで実行ファイルを確認します。
- Apple siliconの既定パスを調べる:
test -x /opt/homebrew/bin/brew && /opt/homebrew/bin/brew --version - Intel Macの既定パスを調べる:
test -x /usr/local/bin/brew && /usr/local/bin/brew --version
バージョンが表示された場合、brewはその場所にあります。コマンド名だけで起動できない原因は、shell設定やPATHにある可能性があります。ファイルが見つからない場合は、既定パスにあるはずだと決めつけず、インストーラーの表示や端末の管理者に確認してください。複数のHomebrewが入っている可能性も含め、Homebrew公式のパス関連トラブル案内を参照できます。
shellに合った設定ファイルを確認する
shell(シェル)は、ターミナルで入力したコマンドを解釈する仕組みです。まずecho "$SHELL"を実行し、現在使っているshellを確認します。macOSのshellについては、Appleのデフォルトshellの確認・変更ガイドも参考になります。
Homebrewのインストーラーは、インストール後にshell設定を更新するよう案内します。公式手順では、実際のインストール先を使ってbrew shellenvを設定します(Homebrew公式のインストール後の手順)。設定が抜けていないか、インストーラーが示した行と設定ファイルを照らし合わせてください。
zshを使っている場合は、通常~/.zprofileが確認候補です。bashの場合は、環境によって~/.bash_profileなどが候補になります。ファイル名を決めつけず、自分のshellとインストーラーの案内を優先してください。たとえば、zshで~/.zprofileを確認するには、次のようにします。
grep -n 'brew shellenv' ~/.zprofile
ファイルが存在しない、または該当行がない場合は、Homebrew公式手順に表示された設定だけを、対応するファイルに追加します。既存の設定を丸ごと置き換えたり、出所が分からないスクリプトを貼り付けたりしないでください。設定ファイルを開く方法やターミナルの扱いは、Appleのターミナルユーザガイドでも確認できます。
確認結果から次の手順を選ぶ
次のチェックリストで、当てはまる項目から進めてください。
- [ ] brewの場所が
command -v brewで表示された
brew --versionを実行します。バージョンが表示されたら、brewは使える状態です。表示されない場合は、エラー内容を記録して公式の案内を確認します。 - [ ] 場所は表示されないが、既定パスに実行ファイルがある
インストーラーの案内とHomebrew公式手順に従い、使っているshellに対応する設定ファイルを確認します。該当設定がなければ、公式に示された行だけを追加します。 - [ ] 既定パスに実行ファイルがない、またはインストールが完了したか分からない
インストール時の表示とエラーを確認します。すぐに再インストールを繰り返さず、Homebrew公式のトラブルシューティング案内で状態を切り分けます。 - [ ] 学校管理のMacで設定変更が制限されている
権限を広げたり管理を回避したりせず、作業を止めて管理者に確認します。
新しいターミナルで設定の反映を確かめる
設定ファイルに行を追加しただけでは、すでに開いているターミナルに反映されない場合があります。ターミナルをいったん終了して開き直し、command -v brewとbrew --versionをもう一度実行してください。ターミナルの起動設定は、Appleのターミナル設定ガイドで確認できます。
新しいターミナルで認識されれば、設定が新しいshellの起動時にも読み込まれています。現在のウィンドウだけで動いて新しいウィンドウでは失敗する場合は、shellの種類、確認した設定ファイル、実際のインストール先を順に見直します。
まだ動かない場合は、次の情報をそろえてから調べ直してください。
echo "$SHELL"の結果command -v brewの結果- 実行ファイルの確認結果と、インストール時に表示された場所
- 設定ファイル内の
brew shellenvの有無
学校のMacで設定を編集できない、または管理者権限が必要と表示される場合は、自分で権限を変更しないでください。管理者にHomebrewの利用条件を確認し、授業で許可された手順を使います。
授業の環境にMacが必要かを切り分ける
Homebrewの設定ミスだけなら、確認するのはインストール状態、配置先、shell設定です。端末そのものの制限で開発環境を用意できない場合は、授業の課題が必要とするツールと、利用できるMac環境を別に確認してください。
Mac環境を選ぶ条件
- 課題でmacOS上の開発ツールが必要で、今の端末では使えない場合は、利用できるMac環境を探します。
- Homebrewの実行ファイルがあり、shell設定だけが不足している場合は、まず公式手順に沿って修正します。
- 学校管理端末で設定が制限されている場合は、管理者の許可を得るまで変更を止めます。
- 手元の端末で課題に必要な操作ができる場合は、環境を増やさず、現在の設定を整えます。
遠隔Macを検討するなら、利用前に授業で必要な操作ができるかを確認してください。MACCOMEの案内はMac環境の利用情報から確認できます。Mac miniの利用を調べる場合は、Mac miniの案内を参照し、自分の課題で必要なソフトや接続方法が使えるかを確かめてください。個別の設定や学校端末の制限が解決すると決めつけず、利用条件を確認してから選びます。
まずはインストールの完了、実際の配置先、shell設定の順で確認し、新しいターミナルでbrewを再検証してください。単に設定が抜けているなら公式手順で直すのが先です。今の端末では授業に必要なMac環境を用意できないと分かった場合に限り、利用条件を確認したうえでMACCOMEの遠隔Macを選択肢に加えてください。