
Macで開発を始めたばかりのあなた。
先輩から「ターミナルでこのコマンド打っておいて」と言われたものの、黒い画面に呪文のような文字列…正直、何が起きているか分からず不安になっていませんか?
「もし変なことになったらどうしよう…」
「エラーが出たら自力で直せる自信がない…」
大丈夫です。その気持ち、痛いほど分かります。筆者も新人の頃は、同じ気持ちでした。
10年以上の開発経験を持つ現役エンジニアとして、今回はMacでの開発に必須のツール「Homebrew」を、初心者の方にも分かりやすく解説します。
この記事で紹介するHomebrew
は、そんなあなたの不安を解消し、Macを最強の開発マシンに変えるための「魔法の杖」です。この記事を読み終える頃には、コマンドラインへの苦手意識がなくなり、自信を持って開発環境を構築できるようになっているはずです。
今回の記事の対象者
この記事は次のような方に向けています:
- macOS Sequoia を使用している 初心者。
- コマンドラインツールや開発環境の構築に興味があるエンジニア、学生。
- macOS で手軽に最新パッケージを管理したいと考えている人。
もくじ
- Homebrewとは?Mac開発の常識を変えるパッケージマネージャ
- 5分で完了!macOS SequoiaへのHomebrewインストール手順
- インストール後の初期設定と環境チェック
- もう迷わない!Homebrew基本コマンド集
- 【中級者への道】Brewfileで開発環境をコード化しよう!
- 開発が捗る!macOS Sequoiaで役立つHomebrewパッケージ
- 安全に使うために:Homebrewのベストプラクティスと注意点
- Homebrew以外の選択肢:代替パッケージマネージャとの比較
- よくある質問(FAQ)
- まとめ
1. Homebrewとは?Mac開発の常識を変えるパッケージマネージャ
Homebrew は macOS を「Linux 風」に変えるパッケージマネージャです。macOS Sequoia の最新コンパイラと組み合わせることで、安定かつ高速に開発環境を構築できます。
主な特徴
機能 | 内容 |
---|---|
パッケージ管理 | macOSで標準的に使われるCLIツール・ライブラリ・GUIアプリをインストール・更新・削除できる高機能なパッケージ管理機能を利用できる。 |
豊富なリポジトリ | https://github.com/Homebrew/homebrew-core – 数万の「formulae(パッケージ)」と「casks(GUIアプリ)」が用意されている。 |
簡単 | 1行でインストールできる。宣言的なformula構文でわかりやすく、依存関係を自動で解決してくれる。 |
コミュニティ | 数千人のコントリビュータが活動中。リリースサイクルは約2–3週間で高速。 |
Apple Silicon対応 | ネイティブarm64バイナリが優先。x86_64はRosetta 2で動く古いパッケージもある。 |
macOS Sequoiaで使う理由
- macOSに標準装備されているツールが古い場合でも、最新バージョンを簡単に入れられます。
- SIP(System Integrity Protection)下でも安全に動作します。
- ソースビルドが必要なときに、最適化されたビルド環境でパッケージをすぐに用意してくれます。
理由 | あなたにとっての意味 |
---|---|
最新パッケージ | macOS には古いシステムライブラリ(例:Python 3.9、Xcode 14)が入っていることがあります。Homebrew は Python 3.12 や LLVM 18、Node 22 など最新バージョンを 導入できます。 |
システム外のインストール場所 | Homebrew はユーザーが書き込み可能なディレクトリ /opt/homebrew にインストールされます。これは、SIP(System Integrity Protection)で保護される /usr/bin 等は触れないので、SIP による「Permission denied」エラーを避けられます。 |
簡単に分離 | 各パッケージは /opt/homebrew/Cellar/... に分離され、brew uninstall foo でシステムに影響を与えません。 |
大規模コミュニティ&バイナリキャッシュ | 30k+の formula があり、pre‑compiled “bottles” でビルド時間を大幅に短縮できます。ソースビルドが必要になった場合は、Homebrew が自動で最新の Xcode/LLVM コンパイラを探し、依存関係を解決してビルドします。 |
Xcode と統合 | --env=all を使うと /opt/homebrew/bin がシェルに追加され、CLI から clang 等をそのまま使えます。 |
「Formula(パッケージ)」と「Casks(GUIアプリ)」
- Formula は「コマンドライン/ライブラリ」向けです。
- Casks は「アプリケーション」向けです。Apple App Store のアプリも含みます。
項目 | 内容 | 代表的なパッケージ例 |
---|---|---|
Formula | 1. ソースコードまたはバイナリを入手・ビルドし、Unix コマンドラインツールやライブラリとしてインストールされます。 2. Formula <name> クラスで定義され、def install にビルド手順が記載されています。3. 依存関係は depends_on で宣言し、Homebrew が自動解決します。 | git, python@3.11, node@20, openssl@1.1 |
Casks | 1. GUI アプリケーション(App Store 版や商用アプリ)を配布します。 2. バイナリ( .dmg ・.pkg ・.zip )をダウンロードし、/Applications へ置くことができます。3. インストール後の自動配置や起動・アンインストールが可能です。 | visual-studio-code, 1password, slack, zoom |
2. 5分で完了!macOS SequoiaへのHomebrewインストール手順
事前準備:Xcode Command Line Toolsのインストール
前提として、コンパイラやGitなど、Homebrewがパッケージをビルド(構築)するために必要な基本ツール群であるXcode Command Line Tools(CLT)が必要です。すでにフルバージョンのXcodeをインストールしていても、CLTが別途必要になる場合があります。
CLTは下記コマンドでインストールします。インストールの途中でダウンロード、ライセンス合意、パスワードの入力が求められます。なお、CLTは約200 MBのサイズがあります。
実行コマンド
xcode-select --install # 1回だけ実行
インストールコマンドを実行すると、以下のメッセージが表示されインストール処理が開始されます。
xxx ~ % xcode-select --install
xcode-select: note: install requested for command line developer tools
xxx ~ %
Xcode Command Line Toolsのインストールの詳細は、以下の記事で詳細に解説していますので、是非ご覧ください。
Homebrewのインストール
初めてHomebrewをインストールする場合は、以下のコマンドを実行します。
# Homebrewのインストールスクリプトをダウンロードして実行します
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
もし、過去にインストールした古いHomebrewが残っていて問題が発生している場合は、一度アンインストールしてから再インストールすることをお勧めします。
# アンインストールスクリプトを実行
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
# 再度インストール
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
インストールが完了したら、次に進みます。
環境変数の設定(PATHを通す)
インストール後、Homebrewのコマンドをターミナルで使えるように「PATHを通す」設定が必要です。
【補足】PATHを通すとは?PATH
とは、コマンドを実行したときに、OSがそのコマンド(プログラム)を探しに行く場所(ディレクトリ)のリストです。
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
この一行は、「ターミナルを起動するたびに、Homebrewのコマンドが置いてある場所 (/opt/homebrew/bin
) を、探しに行く場所リストの最優先にしてね」とお願いするおまじないのようなものです。
これを設定しないと、せっかくbrew install
したコマンドをOSが見つけられず、「command not found」というエラーが出てしまいます。
図:PATHの概念

以下のコマンドで、お使いのMacに合わせた設定を行いましょう。
# シェルの環境変数に Homebrew を追加します。
# ※お使いのMacのアーキテクチャに応じて以下のコマンドを実行します。
# Apple Silicon の場合
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
# Intel Chip の場合
echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
# 設定を現在のシェルに即時反映させます
source ~/.zprofile
# 正しくインストールされたかバージョンを確認します
brew --version # 例: Homebrew 4.3.2
ポイント
- Sequoiaではインストール先が
/opt/homebrew
(Apple Silicon)か/usr/local
(Intel)になります。shellenv
コマンドは PATH、MANPATH、INFOPATH などを設定します。
3. インストール後の初期設定と環境チェック
Homebrewのインストールが完了したら、最初に行う設定と確認作業について説明します。
手順
- Homebrewのデータベースを最新化する
以下のコマンドを実行して、Homebrewが管理するパッケージの情報を最新の状態に更新します。これにより、最新のパッケージをインストールできるようになります。
# Homebrew のデータベースを最新化
brew update
- Homebrewの設定上の警告を確認・修正する
次に、brew doctor
コマンドを実行して、Homebrewの環境に問題がないか診断します。
このコマンドは、権限の問題、競合するファイル、古い設定など、Homebrewの動作に影響を与える可能性のある警告を検出します。
# 設定上の警告を確認・修正
brew doctor
brew doctor
が何らかの警告(Warning)やエラー(Error)を出力した場合は、その指示に従って問題を解消してください。例えば、権限不足のファイルや、Homebrewの動作を妨げる可能性のある競合ファイルなどが指摘されることがあります。
例:問題がない場合
すべての設定が正しく、問題がない場合は、以下のようなメッセージが表示されます。
xxx ~ % brew doctor
Your system is ready to brew.
このメッセージが表示されれば、Homebrewの初期設定は完了です。
4. もう迷わない!Homebrew基本コマンド集
Homebrewを効果的に利用するために、ここでは主要なコマンドとその使い方をまとめました。
日常的に使うコマンドと、いざという時に役立つ重要なコマンドに分けて解説します。
よく使うコマンド
これらのコマンドは、Homebrewを使った日々のパッケージ管理で頻繁に利用します。それぞれの目的と使用例を把握しておきましょう。
目的 | コマンド書式 | コマンド例 |
---|---|---|
Homebrewのデータベースを最新化する | brew update | brew update |
指定したパッケージ(formula)をインストールする | brew install <formula名> | brew install wget |
指定したGUIアプリケーション(cask)をインストールする | brew install --cask <cask名> | brew install --cask visual-studio-code |
インストール済みの全パッケージを最新版にアップグレードする | brew upgrade | brew upgrade |
指定したパッケージをアンインストールする | brew uninstall <formula名> | brew uninstall wget |
パッケージを検索する | brew search <キーワード> | brew search python |
パッケージの詳細情報を表示する | brew info <formula名> | brew info node |
インストール済みの全パッケージ(formulae)を一覧表示する | brew list | brew list |
インストール済みのGUIアプリケーション(casks)を一覧表示する | brew list --cask | brew list --cask |
たまに使うが重要なコマンド
これらのコマンドは日常的に使う機会は少ないですが、Homebrewの環境を健全に保つために重要です。
目的 | コマンド書式 | コマンド例 |
---|---|---|
Homebrewの環境に問題がないか診断し、修正提案を表示する | brew doctor | brew doctor |
古いキャッシュや不要なファイルを削除し、ディスクスペースを解放する | brew cleanup | brew cleanup |
指定したパッケージのインストールされているバージョンを確認する | brew list --versions <formula名> | brew list --versions python |
実際に使うときのコツ
Homebrewを効果的に活用するための重要なポイントを以下に示します。
brew update
とbrew upgrade
を定期的に実行しましょう。
Homebrewのパッケージ情報やインストール済みのソフトウェアを最新の状態にアップグレードするために、定期的に実行することをお勧めします。- 何かが壊れたときは
brew doctor
が必須です。
Homebrewの動作に問題が生じたり、予期せぬエラーが発生した場合は、brew doctor
コマンドを実行してください。このコマンドは、環境内の問題を診断し、解決策を提示してくれます。 - パッケージの最新情報は
brew info <パッケージ名>
で確認できます。
特定のパッケージに関する詳細情報(バージョン、依存関係、インストールパスなど)を確認したい場合は、brew info <パッケージ名>
コマンドを使用します。
補足: brew update
と brew upgrade
brew update
- Git リポジトリ(formulae/casks のメタデータ)をフェッチ。
- バイナリ(bottle)の新バージョンがあるかをチェック。
- 実際のインストールファイルは変更しない。
brew upgrade
brew update
後に自動で実行される。- 既存のインストール済みパッケージを最新版に置き換える。
--greedy
フラグで依存関係をすべて最新化。
5. 【中級者への道】Brewfileで開発環境をコード化しよう!
Homebrewには Brewfile
という機能があり、インストールしたいパッケージのリストをファイルとして管理できます。これを使うと、新しいMacへの環境移行や、チーム内での開発環境の統一が劇的に楽になります。
Brewfileを使うメリット
- 環境の再現性: 新しいMacに環境を移す際、コマンド一つで同じツール群を再現できます。
- チームでの共有: チームメンバー全員が同じバージョンのツールを使えるようになり、「自分の環境でだけ動かない」といった問題を減らせます。
- セットアップの自動化: この
Brewfile
をGitHubなどで管理すれば、あなたの開発環境はいつでもどこでも復元可能な「コード」になります。
Brewfileの使い方
# 現在インストールされているパッケージを元にBrewfileを作成
brew bundle dump
# Brewfileに記述されたパッケージを一括でインストール
brew bundle install
6. 開発が捗る!macOS Sequoiaで役立つHomebrewパッケージ
macOS Sequoia環境で特に役立つパッケージをカテゴリ別に紹介します。これらのパッケージは、開発効率の向上やシステム管理をシンプルにします。
カテゴリ | パッケージ | Sequoia でのメリット |
---|---|---|
システムユーティリティ | coreutils | macOS標準のコマンドはBSD系ですが、coreutils を導入することで、より高機能なGNU版のコマンド(例: ls , cp , mv など)を利用できるようになり、Linux環境に慣れている方には特に便利です。 |
ネットワーク | curl , wget | 最新のTLS 1.3に対応しており、安全なネットワーク通信が可能です。Webからのデータ取得やAPI連携で、より堅牢な環境を構築できます。 |
開発 | python@3.12 , node@22 , go , rust | macOSに標準でインストールされているバージョンよりも新しい、各言語の最新安定版を簡単に導入できます。これにより、最新の機能やライブラリを利用した開発が可能になります。 |
データツール | jq , yq , csvkit | JSON、YAML、CSVといった構造化データをコマンドラインで効率的に操作・変換するための強力なツール群です。データ処理やスクリプト作成の際に、柔軟な対応が可能になります。 |
コンテナ | docker , podman | Docker DesktopのようなGUIアプリケーションを介さずに、コマンドラインから直接コンテナを管理できます。これにより、リソース消費を抑えて、軽量で高速なコンテナ開発環境を構築できます。 |
GUI | visual-studio-code , slack | これらのGUIアプリケーションをHomebrew Caskでインストールすることで、/Applications フォルダへの配置やアップデート管理がHomebrew経由で一元化され、手動での管理の手間を省けます。 |
デスクトップ自動化 | mas | Mac App Storeで購入・ダウンロードしたアプリケーションをコマンドラインから管理できるようになります。アプリケーションのインストールやアップデートをスクリプト化する際に非常に便利です。 |
セキュリティ | gitleaks , snyk | コードベースや依存関係に潜在するセキュリティ上の脆弱性や機密情報の漏洩を自動的にスキャンし、検出するツールです。開発プロセスの早期段階でセキュリティリスクを特定し、対策を講じるのに役立ちます。 |
ここからは、特に利用頻度の高いパッケージをピックアップし、具体的なインストールコマンドと使用例を交えながら、その導入方法を詳しく解説していきます。
6.1 最新 Python のインストール
Homebrewを使ってPythonの特定のバージョンをインストールします。これにより、システムに元々入っているPythonとは別に、最新のPython環境を構築できます。
brew install python@3.12 # /opt/homebrew/bin/python3.12 を提供
仮想環境を作る例:
Pythonでは、依存関係の管理のために仮想環境の利用が推奨されます。
ここでは、venv
モジュールを使った仮想環境の作成とアクティベート方法を示します。
python3.12 -m venv ~/pyproj/env
source ~/pyproj/env/bin/activate
6.2 Node.js を Homebrew でインストール
Node.jsの最新LTS(Long Term Support)版をインストールします。Web開発などでNode.jsが必要な場合に利用します。
brew install node # 最新 LTS を入手
複数バージョンが必要なら nvm
で管理します(Homebrew からインストール)。
複数のNode.jsバージョンを切り替えて使用したい場合は、Homebrewでインストールできるnvm
(Node Version Manager)を利用すると便利です。
「Hello, World」実例
Node.jsの基本的な動作確認と、関連するHomebrewコマンドの応用例です。
# 1. バージョン指定インストール
# 特定のNode.jsバージョンをインストールします。
brew install node@22
# 2. PATH が正しいか確認
# インストールされたNode.jsのバージョンを確認します。
node -v
# 3. シンプルなスクリプト作成
# 簡単なJavaScriptファイルを作成し、Node.jsで実行する例です。
cat > hello.js <<'EOF'
console.log('Hello from Homebrew‑installed Node on Sequoia!');
EOF
node hello.js
6.3 GUI アプリ(Cask)をインストール
--cask
は /Applications
にアプリを配置します。これにより、アプリケーションが/Applications
フォルダに配置され、Homebrewで一元化できるようになります。
以下は、Visual Studio CodeをHomebrew Caskを使ってインストールします。
brew install --cask visual-studio-code
6.4 データベースをインストール
PostgreSQLデータベースのバージョン17をインストールし、バックグラウンドサービスとして起動し、システム起動時に自動的に立ち上がるように設定します。
brew install postgresql@17
brew services start postgresql@17
6.5 コマンドラインツール(例:git)をインストール
Apple の古い git
(2.39.x) ではなく、最新安定版(2.52.x)のGitをインストールします。
macOSに標準で含まれるGitよりも新しいバージョンを利用したい場合に便利です。
brew install git
7. 安全に使うために:Homebrewのベストプラクティスと注意点
Homebrewを安全に利用するためには、ベストプラクティスとして、いくつかの避けるべきことがあります。以下に、特に注意すべき点とその理由をまとめました。
避けるべきこと | 理由 |
---|---|
sudo brew install | Homebrewはユーザー権限で動作するように設計されており、/opt/homebrew (または/usr/local )以下のディレクトリにファイルを書き込みます。sudo を使用すると、Homebrewが管理するファイルの所有権がrootに変更され、その後の操作で権限エラーが発生したり、Homebrewの内部構造が破損したりする恐れがあります。Homebrewの公式ドキュメントでも、 sudo の使用は強く非推奨とされています。(公式ドキュメントはこちら) |
システムパッケージと混在 | macOSのシステムディレクトリ(例: /usr/bin )には、システムが依存する重要なツールが多数含まれています。これらのツールはSIP(System Integrity Protection)によって保護されており、Homebrewでインストールしたパッケージをシステムディレクトリに直接リンクしようとすると、権限エラーが発生します。 また、システムツールをHomebrewで上書きしたり、Homebrewのパスをシステムパスより優先させすぎると、システムが不安定になる原因となります。 |
必要なシステムツールを unlink | brew unlink は、Homebrewでインストールしたパッケージへのシンボリックリンクを解除するコマンドです。しかし、Xcodeなどのシステムが依存する重要なツールに対してこれを行うと、システムや他のアプリケーションの動作に深刻な影響を与える可能性があります。 特に、システムが提供するバージョンとHomebrewでインストールしたバージョンが競合する場合でも、安易な unlink は避けるべきです。 |
シェル設定を手動で書き換える | Homebrewの環境変数(PATH , MANPATH など)は、brew shellenv コマンドによって適切に設定されることが推奨されています。これを手動で ~/.zshrc や~/.bash_profile などに書き換えると、Homebrewのアップデートや環境の変化に対応できなくなり、予期せぬパスの問題やコマンドの競合を引き起こす可能性があります。eval "$(brew shellenv)" を使用することで、常に最新かつ正しい環境設定が適用されます。 |
8. Homebrew以外の選択肢:代替パッケージマネージャとの比較
Homebrewはとても便利で人気がありますが、他にも同じような役割を持つツールがいくつかあります。
以下の表に「代替パッケージマネージャ」を示します。
Homebrewの代替パッケージマネージャ
マネージャ | 特徴 | いいところ | ちょっと大変なところ |
---|---|---|---|
MacPorts | Homebrewよりも歴史が長く、昔から使われているツールです。 | 長い歴史があり、安定して使えます。 | ソフトウェアをインストールするのに時間がかかったり、パソコンの容量を少し多めに使うことがあります。 |
Nix / Home Manager | 最新の技術を使った、とてもきっちりソフトウェアを管理できるツールです。 | ソフトウェアのバージョンを細かく管理でき、同じパソコンに複数のバージョンのソフトウェアを共存させたりできます。 | 仕組みが少し複雑なので、使いこなすには勉強が必要です。 |
Fink | これも歴史のあるツールで、特に古いタイプのソフトウェアを入れるのに向いています。 | 古いソフトウェアをインストールするのに役立ちます。 | 今はあまり活発に開発されておらず、ソフトウェアのインストールに時間がかかることがあります。 |
9. よくある質問(FAQ)
Q. Homebrewは安全ですか?
A. はい、正しく使えば安全です。Homebrewはシステムの重要な部分を書き換えず、専用のディレクトリにパッケージをインストールします。sudo
を使わない、公式以外の不明なtap
(リポジトリ)を追加しない、といった基本ルールを守ることが重要です。
Q. brew doctor
で警告が出たのですが、どうすればいいですか?
A. brew doctor
が示す指示に丁寧に従うのが最善の解決策です。例えば「Warning: /usr/local/bin is not in your PATH.」と出た場合は、PATHの設定が間違っている可能性を示唆しています。記事の「環境変数の設定」の章を再度確認してください。
Q. インストールしたのにコマンドが使えません。(command not found
エラー)
A. ほとんどの場合、PATHの設定が現在のターミナルに反映されていないことが原因です。source ~/.zprofile
を実行するか、ターミナルを再起動してみてください。それでも解決しない場合は、「環境変数の設定」の章を見直しましょう。
Q. Pythonなど、複数のバージョンが混ざって意図しない方が使われます。
A. Homebrewでインストールしたものが優先されるようにPATHが設定されているか確認してください。それでも問題が解決しない場合は、pyenv
のようなバージョン管理ツールをHomebrewでインストールして、より厳密にバージョンを切り替える方法も有効です。
10. まとめ
この記事では、macOS SequoiaにおけるHomebrewの導入から活用までを網羅的に解説しました。
Homebrewを使いこなすことで、macOS Sequoiaでの開発環境構築がより効率的かつ快適になります。この記事があなたの開発者人生の第一歩を力強くサポートできれば幸いです。
Happy hacking! 🎉
本記事をご利用いただくにあたって
この記事は、公開時点(2025年9月)の情報に基づき、正確な情報を提供するよう努めています。
しかし、本記事で解説するソフトウェアやサービスの仕様は日々更新されるため、記事内で紹介している画面や手順が、ご覧いただいている時点では変更されている可能性があります。
もし内容に相違がある場合は、各サービスの最新の公式ドキュメントも併せてご参照ください。本記事の情報を利用される際は、ご自身の判断と責任においてお願いいたします。