macOSにPythonの開発環境を構築する

この記事はHomebrew⁠（新しいタブで開く）を使ってpyenvを入れ、pyenvでPythonをインストールする方法になります。

まだHomebrewを入れていない場合は以下を参考にしてください。

macOSにHomebrewをインストールする

$which python3

▼出力例

1# 出力例2/usr/bin/python3

/usr/bin/python3は、macOSのコマンドライン・デベロッパ・ツールに含まれるPythonです。このPythonはそのままにして、pyenvで入れたPythonを使うようにしていきます。

今回はHomebrewを使ってpyenvをインストールします。

pyenvを使うとPythonのバージョン切り替えが簡単にできるようになります。

GitHub - pyenv/pyenv: Simple Python version management⁠（新しいタブで開く）

ターミナルで以下のコマンドを実行します。

$pyenv --version

▼出力例

以下のように返ってきたらまだpyenvがインストールされていないということになります。

1# 出力例2zsh: command not found: pyenv

1. ターミナルで以下のコマンドを実行してください。

   ターミナルbash · 2行折り返すコピー（ターミナル）

   $brew update$brew install pyenv

2. インストールが完了したら以下のコマンドを実行し、pyenvがインストールされたか確認します。

   ターミナルbash · 1行折り返すコピー（ターミナル）

   $pyenv --version

   ▼出力例

   バージョンが表示されていれば正しくインストールされています。

   テキストテキスト · 2行折り返すコピー（テキスト）

   1# 出力例2pyenv 2.8.7

3. 以下のコマンドを実行して、.zshrcに書き込みます。

   ターミナルbash · 3行折り返すコピー（ターミナル）

   $echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc$echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc$echo 'eval "$(pyenv init - zsh)"' >> ~/.zshrc

4. 先ほどの設定を反映させるために、ターミナルを開き直すか、以下のコマンドを実行します。

   ターミナルbash · 1行折り返すコピー（ターミナル）

   $exec "$SHELL"

pyenvは、Pythonをソースコードからビルドしてインストールします。ビルドに必要なライブラリを、先にHomebrewで入れておきます。

$brew install openssl@3 readline sqlite3 xz tcl-tk@8 libb2 zstd zlib pkgconfig

Suggested build environment - pyenv/pyenv Wiki⁠（新しいタブで開く）

pyenvを使ってPythonをインストールします。

1. ターミナルで以下のコマンドを実行して、インストールできるPythonのバージョンを確認します。

   ターミナルbash · 1行折り返すコピー（ターミナル）

   $pyenv install --list

   ▼出力例

   テキストテキスト · 19行折り返すコピー（テキスト）

   1# 出力例（記事を書いた2024年3月時点。一部抜粋）2  3.11-dev3  3.11.14  3.11.25  3.11.36  3.11.47  3.11.58  3.11.69  3.11.710  3.11.811  3.12.012  3.12-dev13  3.12.114  3.12.215  3.13.0a316  3.13-dev17  activepython-2.7.1418  activepython-3.5.419  activepython-3.6.0

   残り3行を表示

   出力されたPythonのバージョンの中で最新のものが3.12.2になるので今回はこちらをインストールします。

   公式サイトでも記事執筆時点でデフォルトでダウンロードできるバージョンが3.12.2だったのでこちらに合わせています。

   Download Python | Python.org⁠（新しいタブで開く）

   補足

   2026年10月時点では、3.14系（3.14.8）が最新の安定版です。pyenv install 3.14のようにマイナーバージョンまでを書くと、その系列の最新版がインストールされます。

2. 以下のコマンドを実行してPython 3.12.2をインストールします。

   別のバージョンをインストールする場合はバージョン番号の箇所を任意のバージョンに変えてください。

   ターミナルbash · 1行折り返すコピー（ターミナル）

   $pyenv install 3.12.2

3. インストールが完了したら以下のコマンドを実行し、Pythonがインストールされていることを確認します。

   ターミナルbash · 1行折り返すコピー（ターミナル）

   $pyenv versions

   ▼出力例

   先ほどインストールした3.12.2が選択されていれば問題ないですが、私が試したときは以前に入れていた3.11.2が選択されていました。次にバージョンの切り替え作業を行います。

   テキストテキスト · 4行折り返すコピー（テキスト）

   1# 出力例2  system3* 3.11.2 (set by /Users/<ユーザー名>/.pyenv/version)4  3.12.2

4. 以下のコマンドを実行し、Pythonのバージョンを先ほどインストールした3.12.2に切り替えます。

   ターミナルbash · 1行折り返すコピー（ターミナル）

   $pyenv global 3.12.2

5. 再度pyenv versionsを実行すると以下のように出力され、指定したバージョンのPythonが選択されていることが確認できます。

   

   Python 3.12.2が選択されている

   ちなみに、以下のコマンドを実行してもバージョンを確認することができます。

   ターミナルbash · 1行折り返すコピー（ターミナル）

   $python --version

特定のディレクトリでPythonのバージョンを切り替えるには、そのディレクトリ内で以下のコマンドを実行します。ディレクトリに.python-versionというファイルが作られ、そのディレクトリの中ではこのバージョンが使われます。

$pyenv local 3.x.x

pipとはPythonのパッケージ管理ツールです。

pip documentation⁠（新しいタブで開く）

以下のコマンドは、いま選択しているPythonに結びついたpipのバージョンを返します。pip --versionだと、PATHの順番によっては別のPythonのpipが動くことがあるため、python -m pipの形で実行するのが確実です。

$python -m pip --version

▼出力例

1# 出力例2pip 24.0 from /Users/<ユーザー名>/.pyenv/versions/3.12.2/lib/python3.12/site-packages/pip (python 3.12)