Homebrewの使い方|インストール・brew install・upgrade・cask・Appleシリコンでの場所
Mac で開発を始めると、「まず Homebrew を入れてください」と言われることがよくあります。Homebrew(ホームブルー)は、Mac にコマンドやアプリをコマンド 1 つで入れたり、まとめて更新したりできるパッケージ管理ツールです。Windows でいう winget に近い役割です。
この記事では、Homebrew のインストール手順、インストール後に必要な設定(brew shellenv)、Appleシリコンと Intel の Mac でインストール先が違う理由、よく使うコマンド(install・upgrade・uninstall・cleanup・doctor など)、formula と cask の違い、Brewfile での環境の再現、アナリティクス(利用状況の送信)の止め方、安全に使うための注意をまとめます。
この記事の内容は、2026 年 11 月 1 日に確認した Homebrew の公式サイト(brew.sh)・公式ドキュメント(docs.brew.sh)・公式マニュアル(man brew)と、公開されているインストール用スクリプトのソースコードです(2026 年 11 月時点。この時点の最新のメジャー版は 2026 年 9 月公開の Homebrew 7.0.0)。この記事を書いた環境には Mac がないため、コマンドは実機では実行していません。コマンドの書き方は公式ドキュメントに載っているものだけを使い、実行結果の表示例は載せていません。
この記事で使うコマンド
| やりたいこと | 使うコマンド |
|---|---|
| パッケージを探す・情報を見る | brew search/brew info |
| コマンド(formula)を入れる | brew install |
| アプリ(cask)を入れる | brew install –cask |
| 入れたものの一覧を見る | brew list |
| Homebrew 自体とパッケージの情報を新しくする | brew update |
| 古くなったものを確かめる・更新する | brew outdated/brew upgrade |
| アンインストールする・不要な依存を消す | brew uninstall/brew autoremove |
| 古い版やダウンロードの残りを消す | brew cleanup |
| 問題がないか診断する | brew doctor |
| インストール先を表示する | brew –prefix |
| 入れたものを記録・再現する | brew bundle dump/brew bundle |
| アナリティクスを止める | brew analytics off |
Homebrew とは?覚えておきたい用語
Homebrew は Apple の公式ツールではなく、ボランティアが運営するオープンソースのプロジェクトです。Homebrew の説明書には、ビールづくりにちなんだ独特の用語が出てきます。公式マニュアル(man brew)の用語集から、よく出てくるものをかみくだいて紹介します。
| 用語 | 意味 | 例 |
|---|---|---|
| formula(フォーミュラ) | ソースコードから作るタイプのパッケージの定義。主にコマンドラインのツールやライブラリ | wget、git など |
| cask(カスク) | 開発元がビルド・署名した完成品(主に Mac のアプリ)を入れるパッケージの定義 | firefox など |
| bottle(ボトル) | Homebrew があらかじめビルドしておいた formula の完成品。あればこれが使われるので、手元でのビルドが不要になる | — |
| tap(タップ) | formula や cask を集めた置き場(多くは Git リポジトリ) | homebrew/core、homebrew/cask |
| prefix(プレフィックス) | Homebrew がインストールされている場所 | /opt/homebrew |
| Cellar(セラー) | formula の実体がバージョンごとに入る場所 | /opt/homebrew/Cellar |
| Caskroom(カスクルーム) | cask の情報が入る場所 | /opt/homebrew/Caskroom |
| keg-only(ケグオンリー) | Cellar には入れるが、prefix へのリンクを作らない formula。そのままでは PATH が通らない | openjdk など |
Homebrew は formula を Cellar に入れたあと、その一部を prefix(例:/opt/homebrew/bin)にシンボリックリンク(Windows のショートカットのようなもの)で置きます。こうすることで、ほかのプログラムやターミナルから使えるようになります。
動かすための条件
公式ドキュメント「Installation」に書かれている macOS での条件は次のとおりです。
- Appleシリコン(M シリーズのチップ)の Mac。64 ビットの Intel の Mac は、サポートの段階が低い「Tier 3」の扱い
- macOS Sequoia(15)以降。Appleシリコンでは macOS 15 から 27(Golden Gate)が推奨・サポート対象で、macOS 11〜14 はサポート外(動くことはある)。macOS 10.15(Catalina)以前では動かない
- formula をソースコードからビルドするときは、Xcode の Command Line Tools(CLT)か Xcode が必要。Appleシリコンでは、cask と bottle は開発ツールなしで入れられる(Intel の Mac は bottle を入れるときも開発ツールが必要)
- インストールには bash(
/bin/bash)を使う。公式サイトのコマンドは先頭で/bin/bashを指定しているので、ふだん zsh を使っていてもそのまま貼り付けてよい
Intel の Mac については、Homebrew 6.0.0 の公式ブログで段階的にサポートを終えると発表されています。2026 年 9 月に Tier 3(CI でのテストや新しい bottle の作成なし)になり、2027 年 9 月には Intel の macOS(x86_64)は完全にサポート外となり、関係するコードも削除される予定です。Command Line Tools の入れ方は「Xcodeコマンドラインツールとは?インストール方法とxcode-selectの使い方」で説明しています。
インストール手順
インストールのコマンドは、必ず Homebrew の公式サイト(brew.sh)に表示されているものを使ってください。検索結果の広告やまとめサイトにある似たコマンドには、偽のサイトに誘導するものが混ざっていることがあります。2026 年 11 月 1 日時点で公式サイトに表示されていたコマンドは次のとおりです。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
これは「GitHub 上の Homebrew 公式リポジトリ(Homebrew/install)からインストール用スクリプトをダウンロードし、bash で実行する」という意味です。手順は次のとおりです。
- Finder の「アプリケーション」→「ユーティリティ」にある「ターミナル」を開く
- 公式サイトのコマンドをコピーして貼り付け、return キーを押す
- Mac のログインパスワードを聞かれたら入力する(入力しても画面には何も表示されないが、そのまま入力して return キーを押す)
- これから行うこと(作るフォルダーなど)が一覧で表示されて止まるので、内容を読んでから return キーを押して続ける
- 「Installation successful!」のあとに表示される「Next steps」の手順を実行する(次の章で説明)
公式ドキュメントによると、このスクリプトは実行する内容を事前に説明し、すべてを確認してもらってから始める作りになっています。また、既定の場所(Appleシリコンなら /opt/homebrew)に入れるので、最初のインストールのあとは、formula を入れるときに sudo(管理者の権限)が要りません。
ターミナルを使わずに入れたい場合は、Appleシリコン専用の .pkg インストーラーもあります。公式サイトと公式ドキュメントでは、Homebrew/brew の GitHub の最新リリースから入手できると案内されています。こちらも既定の /opt/homebrew に入ります。
インストール後に必ずやること:brew shellenv の設定
公式ドキュメントには、「インストールの最後にシェルの設定を更新する手順が表示される。その手順に従わないと Homebrew は動かない」と書かれています。Appleシリコンの /opt/homebrew/bin は、最初は PATH(コマンドを探しに行くフォルダーの一覧)に入っていないため、そのままでは brew コマンドが見つからないからです。
brew shellenv は、Homebrew を使うための環境変数の設定(PATH・MANPATH・INFOPATH への追加と、HOMEBREW_PREFIX などの設定)を出力するコマンドです。この出力を eval で実行する行をシェルの設定ファイルに書いておくと、ターミナルを開くたびに Homebrew が使えるようになります。
インストール用スクリプトのソースコードを確認すると、macOS で zsh(Mac の標準のシェル)を使っている場合は ~/.zprofile に書き足す手順が表示されます。Appleシリコンの既定の場所に入れた場合は、次の 3 つのコマンドになります。実際には、自分の画面の「Next steps」に表示されたコマンドを優先してください(表示されたものと違う場合は、表示されたほうが正しい手順です)。
1 つ目:設定ファイルの最後に空行を足します。
echo >> ~/.zprofile
2 つ目:brew shellenv を実行する行を設定ファイルに書き足します。
echo 'eval "$(/opt/homebrew/bin/brew shellenv zsh)"' >> ~/.zprofile
3 つ目:いま開いているターミナルにも、同じ設定をすぐ反映します。
eval "$(/opt/homebrew/bin/brew shellenv zsh)"
>> はファイルの最後に追記する記号です。>(1 つ)にすると、ファイルの中身が上書きされて消えてしまうので注意してください。同じ行がすでにある場合は、スクリプトは 3 つ目のコマンドだけを案内します。2 つ目を何度も実行すると同じ行が重複するので、1 回だけ実行しましょう。
なお、公式マニュアルの brew shellenv の説明でも、macOS では ~/.zprofile(bash なら ~/.bash_profile)に書く例が挙げられています。.zprofile と .zshrc の違いは「Macのzsh設定ファイル(.zshrc・.zprofile・.zshenv)の違いとPATH・エイリアスの設定」で説明しています。
正しく入ったか確かめる
ターミナルを開き直してから、次のコマンドで Homebrew の診断をします。
brew doctor
問題が見つかると警告が表示されます。公式マニュアルには、「この警告は Homebrew のメンテナーが問題を調べるためのもので、使っていて困っていなければ気にしなくてよい」と書かれています。何かがうまく動かないときに、手がかりとして見るとよいでしょう。brew が見つからない(「command not found: brew」と出る)場合は、前の手順の brew shellenv の設定ができていない可能性が高いです。
/opt/homebrew と /usr/local の違い(Appleシリコンでの場所)
Homebrew の既定のインストール先は、Mac の種類で違います(公式の FAQ と man brew の --prefix の説明より)。
| 環境 | 既定のインストール先(prefix) |
|---|---|
| Appleシリコンの macOS | /opt/homebrew |
| Intel の macOS | /usr/local(公式は「legacy(古い形)」とし、Tier 3 の扱い) |
| Linux | /home/linuxbrew/.linuxbrew |
FAQ によると、Appleシリコンで /opt/homebrew にしたのは、Appleシリコン用の /opt/homebrew と、Rosetta 2(Intel 用のソフトを Appleシリコンで動かす仕組み)用の /usr/local を共存させ、どちらでも bottle を使えるようにするためです。また、既定の場所に入れると bottle(ビルド済みの完成品)がそのまま使えます。特別な理由がなければ、場所は変えないのがおすすめです。
いま使っている Homebrew の場所は、次のコマンドで表示できます。
brew --prefix
Appleシリコンの Mac で /usr/local と表示されたら、Intel の Mac から移行したときの Intel 用 Homebrew が残っている可能性があります。この確かめ方と対処は「AppleシリコンとIntel Macの違いと、アプリがIntel用か確かめる方法」で詳しく説明しています。古い Homebrew を消す方法は、この記事の「Homebrew 自体をアンインストールする」で紹介します。
基本の使い方
ここからは、公式マニュアル(man brew)と FAQ で確認した基本のコマンドを紹介します。例では、公式ドキュメントでも例に使われている wget(ファイルをダウンロードするコマンド)と、ブラウザーの firefox を使います。
探す・情報を見る(brew search・brew info)
名前の一部で formula と cask を検索します。
brew search wget
入れる前に、説明・バージョン・依存するパッケージなどを確かめます。名前の似た別物を入れてしまわないよう、入れる前に一度見ておくと安心です。
brew info wget
Web ブラウザーで探したい場合は、公式のパッケージ一覧サイト formulae.brew.sh も使えます。
インストールする(brew install)
brew install wget
現在の公式マニュアルでは、brew install と brew upgrade はダウンロードやインストールの前に確認を求める「ask モード」が既定と説明されています。依存するパッケージも含めて何が入るかが表示されるので、内容を確かめてから進めましょう。実際には入れずに、何が入るかだけを見たいときは --dry-run(-n)を付けます。
brew install --dry-run wget
すでに入っていて古くなっている formula を brew install すると、その formula は更新されます(環境変数 HOMEBREW_NO_INSTALL_UPGRADE を設定していない場合)。
入れたものを見る(brew list)
brew list
インストール済みの formula と cask の一覧が表示されます。
更新する(brew update と brew upgrade の違い)
名前が似ていて混乱しやすいのが update と upgrade です。
| コマンド | すること |
|---|---|
| brew update | Homebrew 自体と、パッケージの情報(どのバージョンが最新か)を新しくする。入れたソフトは更新しない |
| brew outdated | 新しいバージョンがある、入れ済みのパッケージを一覧にする |
| brew upgrade | 入れ済みのパッケージを実際に新しいバージョンにする |
FAQ の「How do I update my local packages?」にある順番で実行します。まず情報を新しくします。
brew update
次に、古くなっているものを確かめます。
brew outdated
すべて更新します(固定(pin)したものは除く)。
brew upgrade
特定のものだけ更新したいときは、名前を付けます。
brew upgrade wget
知っておきたい点が 3 つあります。
- 関係のなさそうなものまで更新されることがある:FAQ によると、Homebrew はバージョンの組み合わせを自由に混ぜることをサポートしておらず、依存しているもの・依存されているものも最新にそろえます。特に python や openssl のような基盤のパッケージが更新されると、多くのパッケージが一緒に更新されます
- 自動で update される:
brew install・brew upgrade・brew tapなどの前に、既定では 24 時間に 1 回、自動でbrew updateが実行されます - 古いバージョンは自動で消える:
brew upgradeのあとは、更新したものの古いバージョンが消され(brew cleanupが実行され)、30 日ごとにすべてのパッケージの掃除も行われます
どうしても更新したくないパッケージは、brew pin で固定できます(解除は brew unpin)。ただし、固定したものに依存する別のパッケージが新しいバージョンを必要とするときは、固定していても更新が必要になります。固定は古いバージョンを使い続けることになり、セキュリティの修正も入らなくなるので、必要なときだけにしましょう。
brew pin wget
アンインストールする(brew uninstall・brew autoremove)
brew uninstall wget
ほかの formula の依存として一緒に入り、もう使われなくなったものは、brew autoremove で消せます。何が消えるかを先に見るには --dry-run を付けます。
brew autoremove --dry-run
cask の場合、brew uninstall --cask --zap を使うと、そのアプリに関係するファイル(設定ファイルなど)もまとめて消せます。ただし公式マニュアルには「ほかのアプリと共有しているファイルを消すことがある」と注意書きがあります。アプリの設定を残したいときや、何が消えるかわからないときは、--zap を付けずに普通にアンインストールしましょう。
掃除する(brew cleanup)
brew cleanup は、古いバージョンの formula、古いダウンロードファイル、使われなくなったロックファイルを消します。ダウンロードファイルは、既定で 120 日より古いものが消されます。何が消えるかを先に確かめるには、次のコマンドを使います。
brew cleanup --dry-run
内容を確かめたら、実際に消します。
brew cleanup
前の章のとおり、brew install や brew upgrade のあとにも自動で cleanup が実行されます。ダウンロードファイルの置き場所は brew --cache で表示でき、FAQ によると通常は ~/Library/Caches/Homebrew です。
formula と cask の違い
Homebrew で入れられるものは、大きく formula と cask の 2 種類です。
| formula | cask | |
|---|---|---|
| 主な中身 | コマンドラインのツール・ライブラリ | Mac のアプリ(.app)、フォント、インストーラーなど |
| 誰がビルドするか | Homebrew が公開されたソースコードから自前の CI でビルドした bottle を使う(なければ手元でビルド) | 開発元がビルド・署名した完成品をそのまま使う |
| 入れ方 | brew install 名前 | brew install --cask 名前 |
| 主な置き場所 | /opt/homebrew/Cellar(リンクは /opt/homebrew/bin など) | アプリは既定で /Applications(情報は /opt/homebrew/Caskroom) |
| sudo | 使わない(公式は「formula のインストールはすべて sudo なしで行う」) | .pkg のインストーラーを使うものなど、管理者のパスワードを求めるものがある |
アプリを cask で入れる例です。
brew install --cask firefox
cask について、公式ドキュメント(Homebrew Security and Supply Chain)には次のことが書かれています。
- cask の中身は開発元が作った完成品なので、最終的には開発元を信頼して入れることになる。開発元のインストーラーのスクリプトは Homebrew のサンドボックス(動作を制限する仕組み)の外で動き、Homebrew のフォルダー以外のファイルも変更することがある
- Homebrew は cask のダウンロードに macOS の検疫(quarantine)属性を付け、macOS の Gatekeeper(ゲートキーパー)による署名・公証のチェックを省略させないようにしている
- 公式の cask は、標準の設定の macOS で Gatekeeper のチェックに通ることが求められる。通らない cask は、非推奨→無効→削除の順に外される(マルウェアと判定したという意味ではない)
Gatekeeper の仕組みは「MacのGatekeeperとは?「開発元を確認できない」「壊れているため開けません」の原因と対処」、署名と公証は「Macアプリのコード署名と公証(Notarization)の仕組みと確認方法」で説明しています。
また、アプリ自身に更新機能がある cask(cask の定義に auto_updates true があるもの)は、FAQ によると、普通の brew upgrade では、入っているアプリのほうが新しいか同じなら更新されません(古いと判断できたときだけ更新)。アプリ自身の更新機能で最新にしておけば問題ありません。
Brewfile で入れたものを記録・再現する(brew bundle)
Brewfile は、「この Mac には何を入れておくか」を書いておくテキストファイルです。brew bundle コマンドで、Brewfile に書いた状態にまとめてそろえられます。新しい Mac への移行や、チームで開発環境をそろえるときに便利です。公式ドキュメント「Homebrew Bundle, brew bundle and Brewfile」をもとに説明します。
Brewfile の中身は、たとえば次のように 1 行に 1 つずつ書きます(公式ドキュメントの例から抜粋)。tap は置き場所、brew は formula、cask は cask、restart_service: true はサービス(常駐するプログラム)として起動する指定です。サービスの起動には brew services が使われ、公式マニュアルによると macOS では launchctl で管理されます(launchd の仕組みは「Macのlaunchdとlaunchctlの使い方|cronの代わりに定期実行・常駐させる(plistの書き方)」で説明しています)。
brew "postgresql@16", restart_service: true
cask "firefox"
vscode "editorconfig.editorconfig"
formula と cask のほかに、Mac App Store のアプリ(mas)、VS Code の拡張機能(vscode)、Go・Cargo・npm のパッケージなども書けます。
いまの状態を Brewfile に書き出す
入れ済みの formula・cask・tap などを、いまいるフォルダーの Brewfile に書き出します。公式マニュアルによると、バージョン管理(Git など)に入れて差分を見るのにも向いています。
brew bundle dump
すでに Brewfile があるときに上書きするには --force(-f)を付けます。上書きすると元の内容は消えるので、必要ならコピーを取ってからにしましょう。
Brewfile のとおりにそろえる
Brewfile があるフォルダーで実行すると、書かれているもので足りないものを入れ、古いものを更新します(brew bundle install の短い書き方)。
brew bundle
何かを入れる必要があるかだけを確かめるには、次のコマンドを使います。足りないものを一覧で見たいときは --verbose を付けます。
brew bundle check
brew bundle cleanup は慎重に
brew bundle cleanup は、Brewfile に書かれていないものをすべてアンインストールするコマンドです。公式マニュアルによると、--force を付けなければ消す前に確認を求めます。Brewfile に書き漏れがあると必要なものまで消えるので、確認の表示をよく読み、--force は内容に自信があるときだけにしましょう。
また、Brewfile をほかの人からもらって使うときは、中身を読んでから実行してください。Brewfile に書かれた tap・formula・cask がそのまま入るため、知らない置き場所(tap)やアプリが含まれていないかを確かめることが大切です。
アナリティクス(利用状況の送信)を止める
Homebrew は、匿名で集計した利用状況(アナリティクス)を集めています。インストールの最後にも、アナリティクスが有効になったことと、止め方の説明ページ(Anonymous Analytics)が表示されます。このページによると、次のとおりです。
- 目的は、よく使われるパッケージや対応環境を把握し、失敗が多い箇所を見つけるため
- 送られるのは、パッケージ名、インストールのオプション、CPU の種類、OS の名前と主なバージョン、Homebrew のバージョン、既定の場所に入れているかどうかなど
- 送る内容に、利用者を識別する ID や IP アドレスの項目は含まれない。データは 365 日保存される
- 止める前にイベントが送られないよう、有効になる前にお知らせが表示される(インストール中には送らない)
送りたくない場合は、次のコマンドで止められます(設定は残り続けます)。
brew analytics off
いまの設定を確かめるには、次のコマンドを使います。
brew analytics state
環境変数 HOMEBREW_NO_ANALYTICS=1 を設定する方法もあります(~/.zprofile などに export HOMEBREW_NO_ANALYTICS=1 と書く)。なお、HOMEBREW_ANALYTICS_DEBUG=1 は送る内容を表示するためのもので、送信を止める設定ではないと公式に書かれています。
安全に使うための注意
Homebrew で入れるのは、インターネットから取ってきたプログラムです。公式ドキュメント(Homebrew Security and Supply Chain・Tap Trust・FAQ)をもとに、気をつけたい点をまとめます。
brew に sudo を付けない
Windows で「管理者として実行」する感覚で sudo brew install とするのはやめましょう。FAQ「Why does Homebrew say sudo is bad?」によると、Homebrew は formula のビルドやインストールを持ち主のアカウントの権限で行います。外部のビルド用スクリプトに、システム全体を変更できる権限を与えるべきではないからです。管理者の権限で動かすと、万一おかしなパッケージだった場合の被害が Mac 全体に広がります。
一部の cask やシステムのサービスは管理者の権限を必要とし、Homebrew が必要なときだけパスワードを求めます。そのときは、何を入れようとしているかを確かめてからパスワードを入力してください。権限のエラーが出たときに、/opt/homebrew の持ち主や権限を自分で sudo chown などで変えるのも避け、まず brew doctor の案内を確かめましょう。
公式以外の tap は必要な分だけ信頼する(brew trust)
公式の tap(homebrew/core・homebrew/cask)は、すべての変更を Homebrew のメンテナーが確認してから取り込んでいます。一方、ほかの人や会社が公開している公式以外の tap は、読み込むだけで、その tap の Ruby のコードがあなたの権限で動く可能性があります。
そのため、Homebrew 6.0.0 からは「tap trust」という仕組みが入り、公式以外の tap は、明示的に信頼(trust)しないと読み込まれなくなりました。公式ドキュメント「Tap Trust」では、tap 全体ではなく、使う formula や cask だけを信頼することをすすめています。たとえば、ユーザー名/リポジトリ名/formula名 のように tap の名前まで含めて brew install すると、その formula だけが信頼されます。tap 全体を信頼する(brew trust ユーザー名/リポジトリ名)と、その tap にいまある、そしてこれから追加されるすべてのものを信頼することになります。
公式以外の tap を使うのは、公開している開発元を信頼できる場合だけにしましょう。brew doctor は、信頼されていない公式以外の tap があると警告します。
名前を確かめてから入れる
公式ドキュメントでは、ほかのパッケージ管理の世界で、人気のパッケージに似せた名前の偽物(タイポスクワッティング)や、AI がもっともらしく作り出した存在しない名前を悪用する手口(スロップスクワッティング)が紹介されています。公式の tap では名前をメンテナーが管理しているので対策されていますが、AI やネットの記事に書かれたコマンドをそのまま実行する前に、brew info や formulae.brew.sh で、目的のソフトかどうか(説明・ホームページ)を確かめる習慣をつけましょう。
Gatekeeper の保護を外さない
cask で入れたアプリが開けないときに、ネットで見つけた xattr コマンドで検疫(quarantine)の属性を消したり、Gatekeeper を無効にしたりするのはやめましょう。前の章のとおり、Homebrew は Gatekeeper のチェックを前提に cask の安全性を補っています。対処は「MacのGatekeeperとは?「開発元を確認できない」「壊れているため開けません」の原因と対処」を参考に、まず開発元の公式サイトで正しい配布物か確かめてください。
こまめに更新する
入れたソフトに脆弱性(セキュリティの弱点)が見つかっても、更新しなければ修正は入りません。ときどき brew update と brew upgrade を実行しましょう。現在の公式マニュアルによると、brew upgrade --vulnerable で、OSV.dev(公開されている脆弱性のデータベース)に未解決の脆弱性が登録されている formula だけを選んで更新することもできます(新しいバージョンですべての問題が直るとは限らない、とも書かれています)。
ほかの人に Homebrew のフォルダーを書き換えさせない
公式ドキュメントでは、Homebrew は信頼できる 1 つのアカウントが持ち主になる前提で作られていて、信頼できない人が Homebrew のフォルダーに書き込める状態では、安全を一切保証しないと書かれています。1 台の Mac を複数の人で使う場合は、フォルダーの権限を広げて共有するのは避けましょう。
Homebrew 自体をアンインストールする
FAQ によると、Homebrew をアンインストールするには、Homebrew/install リポジトリのアンインストール用スクリプトを使います。2026 年 11 月 1 日時点でリポジトリの説明に載っていたコマンドは次のとおりです。インストールと同じく、実行する前にリンク先の公式の説明で最新のコマンドを確かめてください。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
Homebrew で入れたものも使えなくなるので、必要なら先に brew bundle dump で Brewfile を作っておきましょう。Intel の Mac から移行したあとに残った /usr/local の Homebrew だけを消したいときは、同じ説明にある、スクリプトをダウンロードして --path /usr/local を付けて実行する方法を使います(詳しいオプションは /bin/bash uninstall.sh --help で確認できると書かれています)。Homebrew を完全に消したあと、~/.zprofile に書き足した brew shellenv の行が残っていたら、その行も削除しておきましょう(残っていると、ない場所の brew を実行しようとします)。
よくあるつまずき
| こまったこと | 考えられる原因と対処 |
|---|---|
| 「command not found: brew」と出る | インストール後の brew shellenv の設定をしていない。「Next steps」の手順を実行し、ターミナルを開き直す |
Appleシリコンなのに brew --prefix が /usr/local | Intel 用(Rosetta)の Homebrew を使っている。Appleシリコン用の /opt/homebrew への入れ直しを検討する |
| 入れたのにコマンドが見つからない | keg-only の formula の可能性。brew info 名前 に理由と PATH に入れる方法が表示される |
| 1 つ入れただけなのに、たくさん更新された | 依存関係を最新にそろえる仕様(FAQ の説明どおり)。異常ではない |
| 公式以外の tap のものが入らない | tap trust で信頼されていない。開発元を信頼できるか確かめてから、必要なものだけ信頼する |
| Mac のアプリ(GUI)から Homebrew のコマンドが見つからない | FAQ によると、GUI のアプリの PATH には既定で Homebrew の場所が入っていない。アプリ側の設定でフルパス(例:/opt/homebrew/bin/コマンド名)を指定できないか確かめる |
まとめ
- Homebrew は Mac のパッケージ管理ツール。インストールのコマンドは必ず公式サイト(brew.sh)のものを使う
- インストール後は「Next steps」に従い、
~/.zprofileにbrew shellenvの行を書き足す。やらないと動かない - 既定の場所は Appleシリコンが
/opt/homebrew、Intel が/usr/local。brew --prefixで確かめられる - よく使うのは search・info・install・list・update・outdated・upgrade・uninstall・autoremove・cleanup・doctor。迷ったら
--dry-runで先に確かめる - formula はコマンドラインのツール、cask は開発元が作ったアプリ。
brew install --caskで入れる brew bundle dumpで記録し、brew bundleで再現できる。brew bundle cleanupは慎重に- アナリティクスは
brew analytics offで止められる - sudo を付けない、公式以外の tap は必要な分だけ信頼する、名前を確かめる、Gatekeeper を外さない、こまめに更新する
関連する記事
- WindowsユーザーのためのMacのターミナル入門|コマンドプロンプト・PowerShellとの対応表
- AppleシリコンとIntel Macの違いと、アプリがIntel用か確かめる方法
- Xcodeコマンドラインツールとは?インストール方法とxcode-selectの使い方
- Macのzsh設定ファイル(.zshrc・.zprofile・.zshenv)の違いとPATH・エイリアスの設定
- MacのGatekeeperとは?「開発元を確認できない」「壊れているため開けません」の原因と対処
- Macのlaunchdとlaunchctlの使い方|cronの代わりに定期実行・常駐させる(plistの書き方)