パッケージ管理したい(brew)

$ brew install フォーミュラ名
$ brew update
$ brew outdated
$ brew upgrade

Homebrewは、macOSやLinuxで使えるパッケージ管理ツールです。

インストールしたい(brew)

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

$ brew --version
Homebrew 6.0.18-113-gecbeb2e
Homebrew/homebrew-cask (git revision c856cc02d26; last commit 2026-08-21)

https://brew.sh/ に書かれているコマンドをコピペして実行すると、Homebrewをインストールできます。 コマンド名はbrewです。

パッケージの詳細を調べたい(brew info)

$ brew info フォーミュラ名

// 例:Brave Browser
$ brew info brave-browser
$ brew home brave-browser

brew infoで、指定したパッケージの詳細情報を表示できます。 パッケージの配布先や依存パッケージ、競合パッケージなどを調べることができます。

brew homeで、指定したパッケージの提供元ウェブサイトやGitHubリポジトリなどを確認できます。 ブラウザが自動で立ち上がり、パッケージの公式情報を確認できます。

brew searchでヒットしたパッケージ名だけでは求めているパッケージかどうか判断できないこともあります。 もしかしたら、同じような名前の別のパッケージかもしれません。 はじめてインストールするパッケージの場合は、brew infoおよびbrew homeで必ず調べるクセをつけておくとよいと思います。

パッケージを更新したい(brew upgrade)

// パッケージリストを更新する
$ brew update

// 更新が必要なパッケージを表示する
$ brew outdated

// パッケージを更新する
$ brew upgrade

brew updateで、Homebrewのパッケージリストを更新できます。 このコマンドは、HomebrewのリポジトリをGitで更新するだけです。 パッケージ自体は更新されません。

brew outdatedで、更新が必要なパッケージを一覧できます。

brew upgradeで、更新があるパッケージをすべて更新できます。 brew upgrade フォーミュラ名で、指定したパッケージだけを更新することもできます。

インストール済みパッケージを確認したい(brew list)

$ brew list

brew listで、インストール済みのパッケージ名を一覧できます。

パッケージを削除したい(brew uninstall)

$ brew uninstall フォーミュラ名

brew uninstallで、インストール済みのパッケージを削除できます。

不要なファイルを削除したい(brew cleanup)

// 削除対象を確認(実際には削除しない)
$ brew cleanup --dry-run

// 実際に削除する
$ brew cleanup

brew cleanupで、不要になったキャッシュなどを削除できます。 --dry-runオプションで、削除対象を事前に確認できます。

パッケージを更新したあと、古いバージョンのパッケージやダウンロードキャッシュが残っていることがあります。 知らないうちに数百MB〜数GB溜まっていることも多いので、定期的に実行しておくとよいです。

自分で依存したパッケージを確認したい(brew leaves)

$ brew leaves

brew leavesコマンドで、自分で明示的にインストールしたパッケージだけを一覧できます。 brew listは依存関係で自動インストールされたパッケージも含まれるため、区別したいときに使います。

依存関係を確認したい(brew deps)

$ brew deps python3
ca-certificates
lz4
mpdecimal
openssl@3
readline
sqlite
xz
zstd

brew depsコマンドで、指定したフォーミュラが依存しているパッケージを確認できます。

環境を診断したい(brew doctor)

$ brew doctor
Your system is ready to brew.

doctorコマンドで、Homebrewの設定に問題がないか診断できます。 問題がない場合は Your system is ready to brew. と表示されます。 インストールがうまくいかないときなど、トラブルシューティングの入口として使います。

パスを知りたい(brew --prefix)

$ brew --prefix
/opt/homebrew

brew --prefixで、Homebrewがインストールされているパスを確認できます。 デフォルトで macOS ARM(Apple Silicon)の場合は/opt/homebrew/、 macOS Intelの場合は/usr/local/、 Linuxの場合は/home/linuxbrew/.linuxbrew/になっています。

$ brew --prefix python3
/opt/homebrew/opt/python@3.14

$ brew --prefix fish
/opt/homebrew/opt/fish

brew --prefix フォーミュラ名で、指定したフォーミュラがインストールされているパスを確認できます。 単体で使うことはあまりなく、シェルスクリプトを組み合わせて使うと便利です。

1cmake -DCMAKE_PREFIX_PATH=$(brew --prefix qt@5)
2# ARMの場合: cmake -DCMAKE_PREFIX_PATH=/opt/homebrew/qt@5
3# Intelの場合: cmake -DCMAKE_PREFIX_PATH=/usr/local/qt@5

上のサンプルでは、cmakeでビルドするときにリンクするqt@5のパスを追加しています。 OSの違いを気にせずに同じコマンドを使いまわすことができます。

フォントを追加したい(homebrew/cask-fonts)

$ brew tap homebrew/cask-fonts

homebrew/cask-fontsは、フォント用のタップです。 フォントを追加したい場合は、 brew tap homebrew/cask-fonts でタップしておく必要があります。

参考

Warning: Formula homebrew/cask-fonts/font-fira-code was renamed to homebrew/cask/font-fira-code.

2024年(のどこか)から、フォントがCaskに取り込まれたようで、 brew tap homebrew/cask-fontsする必要はなくなりました。

$ brew doctor
Warning: You have the following deprecated, official taps tapped:
  Homebrew/homebrew-cask-fonts
Untap them with `brew untap`.

$ brew untap Homebrew/homebrew-cask-fonts
Untapping homebrew/cask-fonts...
Untapped (263 files, 24.9MB).

Google Fontsにあるフォントもインストールできます。

  • brew install font-cherry-bomb-one Cherry Bomb One

  • brew install font-chokokutai Chokokutai)

  • brew install font-darumadrop-one

  • brew install font-dotgothic16

  • brew install font-hachi-maru-pop

  • brew install font-hackgen-nerd

  • brew install font-hackgen HackGen

  • brew install font-klee-one

  • brew install font-merienda-one

  • brew install font-merienda

  • brew install font-monaspace Monaspace

  • brew install font-monomaniac-one Monomaniac One

  • brew install font-noto-sans-cjk-jp

  • brew install font-noto-serif-cjk-jp

  • brew install font-plemol-jp PlemolJP

  • brew install font-rampart-one

  • brew install font-reggae-one Reggae One

  • brew install font-rocknroll-one

  • brew install font-source-han-code-jp

  • brew install font-source-han-sans

  • brew install font-source-han-serif

  • brew install font-stick

  • brew install font-yomogi

  • brew install font-yusei-magic Yusei Magic

シェル設定したい(brew shellenv)

$ brew shellenv
export HOMEBREW_PREFIX="/opt/homebrew";
export HOMEBREW_CELLAR="/opt/homebrew/Cellar";
export HOMEBREW_REPOSITORY="/opt/homebrew";
...

brew shellenvで、PATHなどのHomebrewに関する環境変数の設定コマンドを表示できます。 実行しているシェルに合わせて、出力される構文が自動的に変わります。

evalと組み合わせて、シェルの起動スクリプトに追記しておくことで、brewコマンドや、Homebrewでインストールしたコマンドにパスが通るようになります。

zshの場合

# ~/.zprofile を編集する
# ... 他に設定してある場合はそのままでOK
eval "$(/opt/homebrew/bin/brew shellenv)"

~/.zprofileに追記します。 Homebrewをインストールした末尾に表示されるスクリプトを実行してもOKです。

fishの場合

# ~/.config/fish/config.fish
if status is-interactive
    # Commands to run in interactive sessions can go here
    # ... 他に設定してある場合はそのままでOK
    eval (/opt/homebrew/bin/brew shellenv) # <= ここを追記
end

~/.config/fish/config.fishに追記します。 zsh用の設定と微妙に異なる($や"がいらない)ので注意が必要です。 brew shellenv fishのようにシェル名を明示すると、evalせずにbrew shellenv fish | sourceのように使うこともできます。

エラー:xcrun

$ brew upgrade
xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun
$ xcode-select --install

新しく買ったパソコンだったり、Xcodeをアップグレードしたあとは、Homebrewが動かないときがあります。 xcrunが見つからないエラーの場合、xcode-select --installすると解決します。