brew update と brew upgrade の違いと賢い使い方

2025年7月13日

Homebrew

Mac を使って開発をしていると、必ずといっていいほど Homebrew のお世話になりますね。でも、brew update と brew upgrade の違いをきちんと理解して使い分けている方は、実はそれほど多くないのではないでしょうか。

「なんとなく両方実行しておけば大丈夫」と思っていませんか？実は、この 2 つのコマンドにはそれぞれ明確な役割があり、適切に使い分けることで、より効率的で安全な開発環境を維持できるのです。

本記事では、brew update と brew upgrade の根本的な違いから、実際の現場で役立つ使い方まで、具体例を交えながら詳しく解説していきます。きっとあなたの Homebrew 運用が劇的に変わるはずです。

brew update と brew upgrade の基本的な違い

brew update の役割と動作

brew update は、Homebrew 自体とパッケージの情報を更新するコマンドです。実際のパッケージをアップデートするわけではありません。

具体的には以下の処理を行います：

bash# brew update が実行する処理の流れ
$ brew update

# 1. Homebrew 自体の最新化
# 2. Formula（パッケージ定義）の更新
# 3. Cask（GUI アプリケーション定義）の更新
# 4. 利用可能なパッケージ一覧の更新

実際に実行すると、このような出力が表示されます：

bash$ brew update
Updated 3 taps (homebrew/core, homebrew/cask, homebrew/bundle).
==> New Formulae
awscli-local         git-machete         pnpm
==> Updated Formulae
Updated 847 formulae.
==> New Casks
affinity-designer    figma               notion
==> Updated Casks
Updated 234 casks.

この出力から分かるように、brew update は「どんな新しいパッケージが使えるようになったか」「どのパッケージが更新されたか」という情報を取得しているのです。

brew upgrade の役割と動作

一方、brew upgrade は、実際にインストール済みのパッケージを最新バージョンに更新するコマンドです。

以下が基本的な動作です：

bash# インストール済みパッケージの確認
$ brew list --versions
git 2.39.0
node 18.12.1
python@3.11 3.11.0_1
yarn 1.22.19

# 実際のアップグレード実行
$ brew upgrade
==> Upgrading 2 outdated packages:
git 2.39.0 -> 2.39.1
node 18.12.1 -> 19.2.0

重要なのは、brew upgrade を実行する前に brew update が自動的に実行されることです。これにより、最新のパッケージ情報を取得してからアップグレードが行われます。

両者の関係性と実行順序

ここで多くの方が混乱するポイントを整理しましょう。

コマンド	役割	実行内容
`brew update`	情報更新	パッケージリストの最新化
`brew upgrade`	実際の更新	インストール済みパッケージの更新

重要な気づき：brew upgrade は内部的に brew update を含んでいるため、通常は brew upgrade だけを実行すれば十分です。

しかし、以下のような場面では brew update だけを実行することが有効です：

bash# 新しいパッケージが利用可能か確認したい場合
$ brew update
$ brew search tensorflow

# システムへの影響を最小限に抑えたい場合
$ brew update
$ brew outdated  # 更新対象の確認だけ

実際のコマンド実行例で理解を深める

brew update の実行例

まず、brew update の実行例を詳しく見てみましょう。

bash# brew update の詳細な出力例
$ brew update
Updated 2 taps (homebrew/core, homebrew/cask).
==> New Formulae
acts                 gitlab-runner        pulumi
azure-cli            helm                 terragrunt
docker-compose       kubernetes-cli       volta
==> Updated Formulae
Updated 423 formulae.
git (2.39.0 -> 2.39.1)
node (18.12.1 -> 19.2.0)
python@3.11 (3.11.0 -> 3.11.1)
==> New Casks
brave-browser        postman             visual-studio-code
==> Updated Casks
Updated 156 casks.

この出力から読み取れる重要な情報：

New Formulae: 新しく利用可能になったパッケージ
Updated Formulae: 更新があったパッケージ（まだインストールされていない）
New Casks: 新しく利用可能になった GUI アプリケーション
Updated Casks: 更新があった GUI アプリケーション

brew upgrade の実行例

次に、brew upgrade の実行例を見てみましょう。

bash# 更新対象の確認
$ brew outdated
git (2.39.0 < 2.39.1)
node (18.12.1 < 19.2.0)
python@3.11 (3.11.0 < 3.11.1)

# 実際のアップグレード実行
$ brew upgrade
==> Upgrading 3 outdated packages:
git 2.39.0 -> 2.39.1
node 18.12.1 -> 19.2.0
python@3.11 3.11.0 -> 3.11.1

アップグレード中は、以下のような詳細な出力が表示されます：

bash==> Upgrading git
==> Downloading https://ghcr.io/v2/homebrew/core/git/manifests/2.39.1
Already downloaded: /Users/user/Library/Caches/Homebrew/downloads/abc123...
==> Pouring git--2.39.1.monterey.bottle.tar.gz
🍺  /usr/local/Cellar/git/2.39.1: 1,494 files, 43.4MB

組み合わせた使い方の実践

実際の開発現場では、以下のような使い分けがおすすめです：

bash# 1. 週次メンテナンス：すべてを最新に保つ
$ brew update && brew upgrade

# 2. 特定のパッケージのみ更新
$ brew update
$ brew upgrade git node

# 3. 更新前の確認を重視する場合
$ brew update
$ brew outdated
# 出力を確認してから実行
$ brew upgrade

開発チームでの運用では、以下のような Shell スクリプトを作成しておくと便利です：

bash#!/bin/bash
# brew_maintenance.sh - 安全な Homebrew メンテナンス

echo "🔄 Homebrew の情報を更新中..."
brew update

echo "📋 更新可能なパッケージを確認中..."
outdated=$(brew outdated)

if [ -z "$outdated" ]; then
    echo "✅ すべてのパッケージが最新です"
else
    echo "⚠️  以下のパッケージが更新可能です:"
    echo "$outdated"
    echo
    read -p "アップグレードを実行しますか？ (y/N): " answer
    if [ "$answer" = "y" ] || [ "$answer" = "Y" ]; then
        brew upgrade
        echo "🎉 アップグレードが完了しました"
    fi
fi

効率的な Homebrew 管理テクニック

定期的なメンテナンスの方法

Homebrew を健全に保つためには、定期的なメンテナンスが重要です。以下のコマンドを組み合わせて使用しましょう：

bash# 週次メンテナンススクリプト
$ brew update                    # 情報更新
$ brew outdated                  # 更新対象確認
$ brew upgrade                   # パッケージ更新
$ brew cleanup                   # 不要ファイル削除
$ brew doctor                    # システムチェック

brew cleanup は特に重要で、古いバージョンのパッケージファイルを削除してディスク容量を節約します：

bash$ brew cleanup
Removing: /usr/local/Cellar/git/2.38.1... (1,494 files, 43.1MB)
Removing: /usr/local/Cellar/node/18.10.0... (3,137 files, 63.2MB)
Removing: /Users/user/Library/Caches/Homebrew/downloads/abc123...
==> This operation has freed approximately 486.7MB of disk space.

特定のパッケージのみ更新する方法

すべてのパッケージを一度に更新するのが不安な場合は、特定のパッケージのみを更新することも可能です：

bash# 特定のパッケージのみアップグレード
$ brew upgrade git
$ brew upgrade node python@3.11

# 特定のパッケージを更新対象から除外
$ brew pin node              # node を固定
$ brew upgrade               # node 以外を更新
$ brew unpin node            # 固定を解除

開発環境の安定性を重視する場合は、以下のような段階的更新がおすすめです：

bash# 1. 重要度の低いツールから更新
$ brew upgrade wget curl jq

# 2. 開発ツールの更新（テスト環境で確認後）
$ brew upgrade git

# 3. ランタイムの更新（慎重に）
$ brew upgrade node python@3.11

更新前の確認とバックアップ

重要なプロジェクトで作業している場合は、更新前の確認とバックアップが重要です：

bash# 現在の環境を記録
$ brew list --versions > brew_backup_$(date +%Y%m%d).txt

# 更新対象の詳細確認
$ brew outdated --verbose

# 特定パッケージの依存関係確認
$ brew deps --tree node

よくある問題とその解決策

エラー発生時の対処法

Homebrew を使用していると、以下のようなエラーに遭遇することがあります。実際のエラーコードと解決方法を見てみましょう。

Error: Permission denied @ rb_sysopen

bash$ brew update
Error: Permission denied @ rb_sysopen - /usr/local/var/homebrew/locks/update_running

この権限エラーは、Homebrew のディレクトリの所有者が正しく設定されていない場合に発生します：

bash# 解決方法1: Homebrew ディレクトリの所有者を修正
$ sudo chown -R $(whoami) /usr/local/var/homebrew

# 解決方法2: 強制的にロックファイルを削除
$ rm /usr/local/var/homebrew/locks/update_running
$ brew update

Error: Could not resolve HEAD to a revision

bash$ brew update
Error: Could not resolve HEAD to a revision
/usr/local/Homebrew/.git/refs/heads/master

このエラーは Git リポジトリが破損している場合に発生します：

bash# 解決方法: Homebrew の Git リポジトリを修復
$ cd /usr/local/Homebrew
$ git status
# 破損状態を確認

$ git fetch origin
$ git reset --hard origin/master

依存関係の問題への対応

複雑な依存関係があるパッケージでは、以下のようなエラーが発生することがあります：

Error: The following formula cannot be installed due to dependency conflicts

bash$ brew upgrade
Error: The following formula cannot be installed due to dependency conflicts:
python@3.11: conflicts with python@3.10

この場合は、段階的にパッケージを更新する必要があります：

bash# 1. 依存関係を確認
$ brew deps --tree python@3.11

# 2. 競合するパッケージを特定
$ brew list | grep python

# 3. 古いバージョンをアンインストール
$ brew uninstall python@3.10

# 4. 新しいバージョンをインストール
$ brew install python@3.11

より安全な方法として、以下のコマンドで依存関係を自動解決することも可能です：

bash# Homebrew に依存関係の解決を委ねる
$ brew upgrade --force-bottle

容量不足時の対策

Homebrew を長期間使用していると、キャッシュファイルが蓄積されて容量不足になることがあります：

Error: No space left on device

bash$ brew upgrade
Error: No space left on device @ rb_sysopen - /usr/local/Cellar/...

このエラーが発生した場合は、以下の手順で容量を確保しましょう：

bash# 1. 現在の容量使用状況を確認
$ brew --cache  # キャッシュディレクトリの場所を確認
$ du -sh $(brew --cache)  # キャッシュサイズを確認

# 2. 古いバージョンとキャッシュを削除
$ brew cleanup --prune=all

# 3. より積極的な容量削減
$ brew cleanup --prune=0  # すべてのキャッシュを削除

定期的なメンテナンスで容量問題を予防することも重要です：

bash# 週次実行推奨のクリーンアップスクリプト
#!/bin/bash
echo "🧹 Homebrew のクリーンアップを開始..."

# 古いバージョンを削除（30日以上古いもの）
brew cleanup --prune=30

# 使用していないパッケージを確認
brew autoremove

# 使用容量を表示
echo "📊 現在の Homebrew 使用容量:"
du -sh /usr/local/Cellar
du -sh $(brew --cache)

echo "✅ クリーンアップが完了しました"