Mac OS XにHomebrewでPython 3をインストールする方法

この記事では、Mac OS XにHomebrew（brew）を使ってPython 3をインストールする手順をわかりやすく解説します。あわせて、インストール時によく発生する権限エラーの対処法もご紹介します。

Homebrewを使ってMac OS XにPython 3をインストールする

すでにMacにbrewがインストールされている前提で進めます。まずは以下のコマンドを実行して、Homebrewの動作状態をチェックしましょう。

brew doctor

「Your system is ready to brew.」と表示されれば問題ありません。続いて、次のコマンドでPython 3をインストールします。

brew install python3

「link」や「Frameworks」関連のエラーが出た場合の対処法

インストール中に、以下のようなlinkやFrameworksに関連するエラーメッセージが表示されることがあります。

Error: An unexpected error occurred during the `brew link` step
The formula built, but is not symlinked into /usr/local
Permission denied @ dir_s_mkdir - /usr/local/Frameworks
Error: Permission denied @ dir_s_mkdir - /usr/local/Frameworks

このエラーは、/usr/local/Frameworksディレクトリへの書き込み権限が現在のユーザーにないことが原因です。以下のコマンドを順番に実行することで解決できます。

sudo chown -R $(whoami) $(brew --prefix)/*
# ※ $(brew --prefix)/* の部分はそのまま使えます
sudo install -d -o $(whoami) -g admin /usr/local/Frameworks

1つ目のコマンドでHomebrewのプレフィックス配下の所有者を自分のユーザーアカウントに変更し、2つ目のコマンドでadminグループ権限を持つFrameworksディレクトリを作成しています。

コマンド実行後、再度brew install python3を実行すればインストールが完了します。最後にpython3 --versionを実行して、バージョン情報が正しく表示されれば成功です。