pyenv/pyenv-virtualenv

これは何？

主な機能

• 01pyenvでインストールした任意のPythonバージョンをもとにvirtualenvを作成できます。
• 02既存のvirtualenvとconda環境を一覧表示・削除できます。
• 03ディレクトリの.python-versionファイルに基づいて環境を自動で有効化します。
• 04conda、virtualenv、組み込みのvenvモジュールを利用できます。
• 05有効な環境を示すシェルプロンプトをカスタマイズできます。

ユースケース

• macOSやLinuxのマシンで、プロジェクトごとにPython環境を分けて管理する。
• シェルでディレクトリを移動したとき、プロジェクトの環境を自動で切り替える。
• pyenvでインストールしたPythonバージョンとあわせてconda環境を管理する。

クイックスタート

1. 1

   pyenv-virtualenv を pyenv のプラグインディレクトリにチェックアウトします

   git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
2. 2

   必要に応じて、シェルで自動有効化するために pyenv virtualenv-init を追加します

   echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc
3. 3

   シェルを再起動して pyenv-virtualenv を有効にします

   exec "$SHELL"
4. 4

   pyenv で管理されている Python バージョンを使って virtualenv を作成します

   pyenv virtualenv 2.7.10 my-virtual-env-2.7.10

使う前に知っておきたいこと

• !UNIX 系システムのみ対応しています。pyenv のプラグインのため、pyenv のインストールが必要です。
• !pyenv が必要なため、先に pyenv をセットアップしてください。

トピック

よくある質問

pyenv-virtualenv とは？

UNIX系システムでPythonのvirtualenvとconda環境を作成、一覧表示、有効化、削除できるpyenvプラグイン。 pyenv-virtualenvは、Pythonのバージョン管理ツールであるpyenvを拡張し、仮想環境を管理するコマンドを追加します。`pyenv virtualenv`でインストール済みの特定のPythonバージョンをもとにvirtualenvを作成し、`pyenv virtualenvs`で既存の環境を一覧表示、`pyenv virtualenv-delete`で削除できます。オプションは、conda、virtualenv、標準の`python -m venv`モジュールのいずれか、実際に環境を作成するツールに渡されます。

pyenv-virtualenv は無料で使えますか？ライセンスは？

pyenv-virtualenv は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

pyenv-virtualenv は今もメンテナンスされていますか？

活発にメンテナンス中。pyenv-virtualenv の最終コミットは 2026年10月12日 です。

pyenv-virtualenv は何に使えますか？

macOSやLinuxのマシンで、プロジェクトごとにPython環境を分けて管理する。 シェルでディレクトリを移動したとき、プロジェクトの環境を自動で切り替える。 pyenvでインストールしたPythonバージョンとあわせてconda環境を管理する。

pyenv-virtualenv のインストール方法は？

pyenv-virtualenv を pyenv のプラグインディレクトリにチェックアウトします: git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv 必要に応じて、シェルで自動有効化するために pyenv virtualenv-init を追加します: echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc シェルを再起動して pyenv-virtualenv を有効にします: exec "$SHELL" pyenv で管理されている Python バージョンを使って virtualenv を作成します: pyenv virtualenv 2.7.10 my-virtual-env-2.7.10

pyenv-virtualenv はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/pyenv/pyenv-virtualenv