お問い合わせ
MacにHomebrewをインストールする方法!基本コマンドも合わせて解説

MacにHomebrewをインストールする方法!基本コマンドも合わせて解説

Jay-Piy wabi_motion

MacにHomebrewをインストールする方法!基本コマンドも合わせて解説

MacにHomebrewをインストールする手順を解説。基本コマンド・よくあるエラーの対処法・おすすめパッケージまでまとめました。Apple Silicon対応のパス設定も含めて初心者でも迷わず進められます。

MacBookを使っている方にとって、Homebrewはほぼ必須のツールです。「Homebrewって名前は聞いたことあるけど何者?」という方から「インストール方法がわからない」という方まで、基本的な使い方を含めてまとめて解説します。

Homebrewとは何か

HomebrewはMac用のパッケージマネージャーです。ターミナルからコマンド一つでソフトウェアのインストール・アップデート・アンインストールができます。

Homebrewがない状態でNode.jsやGitをインストールしようとすると、公式サイトに行ってダウンロードして、インストーラーを実行して…という手順が必要です。Homebrewがあれば以下のコマンドで終わります。

brew install node
brew install git

それだけではなく、依存関係(そのソフトウェアが必要とする別のソフトウェア)も自動でインストールしてくれます。開発環境を整える時間が大幅に短縮されます。

Homebrewのインストール前に確認すること

インストール前に以下を確認しておくと後でつまずきません。

① macOSのバージョン確認

Homebrewは最新またはその1つ前のmacOSバージョンを推奨しています。古すぎるとインストールできない場合があります。

# macOSのバージョン確認
sw_vers -productVersion

② Command Line Toolsの確認

HomebrewはXcodeのCommand Line Toolsが必要です。事前にインストールしておきましょう。

# Command Line Toolsのインストール
xcode-select --install

# インストール済みか確認
xcode-select -p
# /Library/Developer/CommandLineTools と表示されればOK

Command Line Toolsがインストールされていない状態でHomebrewをインストールしようとすると自動的に促されますが、先にやっておく方が流れがスムーズです。

③ インターネット接続の確認

Homebrewのインストール中にファイルをダウンロードするため、安定したインターネット接続が必要です。途中で接続が切れるとインストールが中断されます。

Homebrewのインストール手順

# ターミナルを開いて以下のコマンドを実行
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

実行するとパスワードの入力を求められます。Macのログインパスワードを入力してEnterを押してください。入力中は画面に文字が表示されませんが、正常な動作です。

インストール中にいくつか確認が出ますが、基本的にEnterを押して進めていけば完了します。数分かかることがあるので待ちましょう。

Apple Silicon(M1・M2・M3)Macの場合の追加設定

Apple Siliconの場合、インストール後にパスの設定が必要です。インストール完了時に画面に表示される案内通りに進めてください。

# Apple Silicon MacでHomebrewのパスを設定
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Intel Macの場合はこの手順は不要です。

インストール確認

インストールが完了したら正しく動作するか確認します。

# バージョン確認
brew --version

# 正常にインストールされていれば以下のように表示される
Homebrew 4.x.x

# 「command not found」と表示される場合はパスの設定が必要
# Apple Silicon Macは上記のパス設定を確認してください

「command not found」と出た場合はターミナルを再起動して再度確認してください。それでも出る場合はパスの設定が正しくできていない可能性があります。

基本コマンド一覧

Homebrewで日常的に使うコマンドをまとめます。

パッケージの検索

# パッケージ名で検索
brew search git

# パッケージの詳細情報を確認
brew info node

パッケージのインストール

# パッケージをインストール
brew install node
brew install git
brew install wget

# よく使う開発ツールのまとめインストール例
brew install node git wget curl

パッケージのアップデート

# Homebrew自体を更新
brew update

# インストール済みパッケージを全て最新化
brew upgrade

# 特定のパッケージだけ更新
brew upgrade node

インストール済みパッケージの確認

# インストール済みパッケージの一覧
brew list

# アップデート可能なパッケージを確認
brew outdated

パッケージのアンインストール

# パッケージを削除
brew uninstall node

# バージョン付きパッケージを削除する場合
brew uninstall node@18

# 依存関係を無視して削除(注意が必要)
brew uninstall --ignore-dependencies パッケージ名

アンインストール時に「他のパッケージが依存している」という警告が出ることがあります。その場合は無理に削除せず、依存関係を確認してから判断してください。

不要ファイルの削除

# 古いバージョンのファイルを削除してストレージを節約
brew cleanup

# 削除前に何が消えるか確認
brew cleanup --dry-run

よくあるエラーと対処法

# エラー①:command not found: brew
原因:パスが設定されていない
対処:ターミナルを再起動、またはパス設定を確認

# エラー②:Error: /opt/homebrew/bin is not in your PATH
原因:Apple Silicon MacでHomebrewのパスが通っていない
対処:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

# エラー③:brew updateでエラーが出る
原因:Gitのバージョンが古いまたはネットワーク問題
対処:
xcode-select --install
を再実行してCommand Line Toolsを更新

# エラー④:依存関係の競合
原因:異なるバージョンのパッケージが混在
対処:
brew doctor
で問題を診断して指示に従う

Homebrewで入れておきたいおすすめパッケージ

MacBook使いのエンジニアがとりあえず入れておくと便利なパッケージです。

# 開発系
brew install node        # JavaScript実行環境
brew install python      # Python
brew install git         # バージョン管理
brew install gh          # GitHub CLI
brew install awscli      # AWS CLI

# ユーティリティ系
brew install wget        # ファイルダウンロード
brew install curl        # HTTPリクエスト
brew install tree        # ディレクトリ構造を表示
brew install jq          # JSONの整形・フィルタ

# 全部まとめてインストール
brew install node python git gh awscli wget curl tree jq

まとめ

MacBookで開発をするなら、Homebrewは入れておいて損がないツールです。インストール自体は5分もあれば完了します。Apple Silicon Macの場合はパスの設定を忘れずに。インストール後は定期的にbrew update && brew upgradeを実行して最新の状態を保つ習慣をつけておくと快適に使い続けられます。

最後までお読みいただき、誠にありがとうございました。

ITエンジニアとして働きながら、AI・映像制作・AWSについて実体験をもとに発信しています。少しでも参考になれば嬉しいです。

他の記事もぜひ読んでみてください。