Macで別バージョンのPythonの仮想環境を構築する方法

概要

Macにおいて仮想環境を作成して、そこにすでにインストールされているバージョンとは異なるPythonを構築する方法をまとめる。

注: 自分用のためここに記載されたこと以外のことを設定しなければならない可能性がある。

前提条件

• Macであること。
• コマンドpyenvがインストールされていること。

やりたいこと

• 現状自分のMacには3.9.2と3.10.7のバージョンのPythonがインストールされている。

• やりたいことは特定のディレクトリに仮想環境を作成して、そこに新しいバージョンのPython(3.11.3)にしたい。

• before:

• after:

方法

STEP 1 pyenvをアップデートする

• 最新のPythonのバージョンをインストールしたいので、pyenvをアップデートします。pyenvには直接アップデートのコマンドがありませんので、次のコマンドを実行します。

cd ~/.pyenv/plugins/python-build/../.. && git pull && cd -

STEP 2 インストールしたいバージョンを確認する

• インストールしたいPythonのバージョンを次のコマンドで確認します。

Available versions:
  2.1.3
  2.2.3
  2.3.7
  2.4.0
  2.4.1

(略)

  3.8.16
  3.9.0
  3.9-dev
  3.9.1
  3.9.2
  3.9.4
  3.9.5
  3.9.6
  3.9.7
  3.9.8
  3.9.9
  3.9.10
  3.9.11
  3.9.12
  3.9.13
  3.9.14
  3.9.15
  3.9.16
  3.10.0
  3.10-dev
  3.10.1
  3.10.2
  3.10.3
  3.10.4
  3.10.5
  3.10.6
  3.10.7
  3.10.8
  3.10.9
  3.10.10
  3.10.11
  3.11.0
  3.11-dev
  3.11.1
  3.11.2
  3.11.3
  3.12.0a7
  3.12-dev
  activepython-2.7.14
  activepython-3.5.4
  
  (略)

  stackless-3.4.7
  stackless-3.5.4
  stackless-3.7.5

STEP 3 インストールしたいバージョンをインストールする

• 確認後に次のコマンドでインストールします。インストールするまで少し時間がかかります(1分ぐらい)。

pyenv install <version>

今回はpyenv install 3.11.3です。

STEP 4 インストールしたことを確認する

• 実際うまく期待通りのバージョンがインストールされたかどうかを次のコマンドで確認します。問題なく3.11.3が追加されています。

pyenv versions

* system (set by /Users/yoheiwatanabe/.pyenv/version)
  3.9.2
  3.10.7
  3.11.3

• ここでは設定はsystemが設定されています(*が目印)。

STEP 5 仮想環境に設定したいバージョンに変更する

• 仮想環境に設定したいバージョンに次のように変更します。

pyenv local 3.11.3

• pyenv versionsで確認すると*が3.11.3に移動しています。

STEP 6 仮想環境を設定する

• 設定したいディレクトリ配下に移動して、仮想環境を次のように設定します。今回は仮想環境名を.venvとしていますが、それは任意で問題ありません。

python -m venv .venv

STEP 7 仮想環境に入る/出る

• 仮想環境にはsource .venv/bin/activateで入ります(アクティベイトします)。
• バージョンは期待通り3.11.3となっています。
• 仮想環境から出る場合(デアクティベイト)はdeactivateを実行します。

僕から以上