pyenv-virtualenvとは？初心者が知るべき使い方とインストール手順共起語・同意語・対義語も併せて解説！

この記事を書いた人

高岡智則

年齢：33歳性別：男性職業：Webディレクター（兼ライティング・SNS運用担当）居住地：東京都杉並区・永福町の1LDKマンション出身地：神奈川県川崎市身長：176cm 体系：細身〜普通（最近ちょっとお腹が気になる）血液型：A型誕生日：1992年11月20日最終学歴：明治大学・情報コミュニケーション学部卒通勤：京王井の頭線で渋谷まで（通勤20分）家族構成：一人暮らし、実家には両親と2歳下の妹恋愛事情：独身。彼女は2年いない（本人は「忙しいだけ」と言い張る）

pyenv-virtualenvとは？

pyenv-virtualenv は、Python の仮想環境を作成・切り替えを楽にする、pyenv の拡張プラグインです。仮想環境とは、プロジェクトごとに異なるライブラリの組み合わせを分けて管理する仕組みのこと。これにより、別のプロジェクトで使っているパッケージのバージョンが干渉せず、環境を壊す心配が少なくなります。

pyenv 自体は複数の Python バージョンを切り替えるツールです。pyenv-virtualenv を使うと、仮想環境の作成と切り替えが簡単になり、「その場で使うライブラリだけを入れる」という運用が手軽になります。

どんな時に使うと良いか

新しい Python バージョンを試したい場合や、複数のプロジェクトで異なるライブラリの組み合わせを使う場合に有効です。コマンド一つで環境を作成・有効化・切り替えができるので、学習にも実務にも役立ちます。

実用的な使い方の流れ

ステップ 1: pyenv をインストールします。OS によって手順が異なりますが、公式ドキュメントの指示に従いましょう。
ステップ 2: pyenv-virtualenv を導入します。通常はプラグインを追加する形で setup します。
ステップ 3: Python のバージョンをインストールします。例: <span>pyenv install 3.11.2
ステップ 4: 仮想環境を作成します。例: pyenv virtualenv 3.11.2 myenv
ステップ 5: 仮想環境を有効化します。例: pyenv activate myenv、終了時は pyenv deactivate。
ステップ 6: 特定のプロジェクトに対して環境を紐づけます。例: pyenv local myenv。これでそのディレクトリ内で自動的にその環境が使われます。

よく使うコマンドの一覧

<th>コマンド

用途	例
pyenv install <version>	指定バージョンの Python をインストール	pyenv install 3.11.2
pyenv virtualenv <version> <name>	仮想環境を作成	pyenv virtualenv 3.11.2 myenv
pyenv activate <name>	環境を有効化	pyenv activate myenv
pyenv deactivate	環境を無効化	pyenv deactivate
pyenv local <name>	現在のディレクトリに環境を設定	pyenv local myenv
pyenv which python	現在の環境の Python の場所を確認	pyenv which python

プロジェクトと運用のポイント

プロジェクトごとに仮想環境を使うと、依存関係の衝突を避けられます。ローカルファイルとして .python-version がその環境を指す情報を持つため、リポジトリを他の人と共有したときにも同じ環境を再現しやすいのが特徴です。

注意点

pyenv-virtualenv は pyenv の拡張機能ですが、OS やシェルの設定によっては起動時の初期設定が必要なことがあります。公式の手順を確認して、パスが正しく通っているかを確認しましょう。

pyenv-virtualenvの同意語

pyenv-virtualenv: pyenvとvirtualenvを組み合わせて、Pythonのバージョンごとに仮想環境を自動的に作成・切替・管理するプラグイン。
pyenv用仮想環境管理プラグイン: pyenvを使って仮想環境の作成・有効化・削除などを一元的に行えるプラグイン。
pyenvとVirtualenvの統合プラグイン: pyenvとvirtualenvの機能を一つのツールで連携させ、バージョン管理と仮想環境管理を同時に扱えるプラグイン。
Python バージョン別仮想環境作成ツール: 特定のPythonバージョンごとに対応する仮想環境を作成・管理する機能を提供するツール。
仮想環境自動作成機能（pyenv風）: Pythonのバージョンを切替える際に、対応する仮想環境を自動で作成・有効化する機能。
pyenv 仮想環境連携ツール: pyenvと仮想環境を連携させ、バージョンごとの仮想環境の作成・切替をスムーズに行えるツール。

pyenv-virtualenvの対義語・反対語

グローバルPythonのみ使用: 仮想環境を使わず、OSが提供するグローバルなPythonをそのまま使い、パッケージをすべてグローバルにインストール・管理する運用。
システムPython: OSが提供するデフォルトのPython。pyenvや仮想環境を介さずに使う状態。
仮想環境なし: 仮想環境を作成せず、複数プロジェクト間で環境を分離せず1つの環境で作業する状態。
pyenvを使わない: Pythonのバージョン管理ツールとしてpyenvを使わず、現在の環境はグローバルなPythonを前提とする状態。
単一環境: 複数プロジェクトで別々の環境を持たず、1つのPython環境だけを共有して使う状態。
環境分離をしない: プロジェクトごとに環境を分離せず、1つの共通環境を使い回す状態。
バージョン固定を行わない: 特定のPythonバージョンを固定せず、都度異なるバージョンで作業する運用。

pyenv-virtualenvの共起語

pyenv: 複数のPythonバージョンを共存させ、切り替えを容易にするツール。
pyenv-virtualenv: pyenv用のプラグインで、pyenvと仮想環境(virtualenv)を連携して管理できるようにする。
virtualenv: Pythonの仮想環境を作成するツール。依存関係をプロジェクトごとに分離する。
venv: Python標準の仮想環境機能。小規模なプロジェクトに用いられる。
Python バージョン管理: 同じマシン上で複数のPythonバージョンを扱い、プロジェクトごとに使い分ける考え方。
仮想環境: 依存関係を他のプロジェクトと分離する「独立した実行環境」のこと。
.python-version: 現在のディレクトリで使うPythonバージョンや仮想環境を指示するファイル。
pyenv install: 指定したPythonバージョンをインストールするコマンド。
pyenv global: 全体的に適用されるデフォルトのPythonバージョンを設定するコマンド。
pyenv local: 特定のディレクトリに適用するPythonバージョンを設定するコマンド。
pyenv versions: インストール済みのPythonバージョンと仮想環境の一覧を表示するコマンド。
pyenv init: シェルをpyenvが使えるように初期化する設定コマンド。
pyenv-virtualenv-init: シェルにpyenv-virtualenvの機能を有効化する初期化コマンド。
pyenv activate: 特定の仮想環境をアクティブ化するコマンド。
pyenv deactivate: 現在の仮想環境を非アクティブ化するコマンド。
pyenv which: 現在有効な実行ファイルの場所を表示するコマンド。
pip: 仮想環境内でパッケージを管理するためのPythonのパッケージ管理ツール。
requirements.txt: プロジェクトで使う依存パッケージを列挙するファイル。
macOS: macOSでの実行環境。Homebrew経由でのインストールが一般的。
Linux: Linuxでの実行環境。aptやdnfなどパッケージマネージャを使って準備することが多い。

pyenv-virtualenvの関連用語

pyenv: Python の複数バージョンを共存させ、プロジェクトごとに使う Python バージョンを切り替えるためのツール。シェルの shims を使って、実行時に適切なバージョンを自動的に選びます。
pyenv-virtualenv: pyenv と virtualenv の統合を実現するプラグイン。pyenv の下で仮想環境を作成・切替・管理でき、特定の Python バージョンに紐づく仮想環境を簡単に運用できます。
virtualenv: Python の仮想環境を作成するツール。環境ごとにパッケージを分離してインストールでき、プロジェクト間の依存関係の衝突を防ぎます。
venv: Python 標準ライブラリに含まれる仮想環境作成モジュール（Python 3.3 以降）。軽量で手軽に仮想環境を作成できます。
pyenv-virtualenvwrapper: pyenv と virtualenvwrapper の連携を提供する補助ツール。仮想環境の管理を統一的に行うための補助機能です。
virtualenvwrapper: virtualenv を使いやすくするためのシェルスクリプト群。環境の作成・切替・削除を容易にするコマンド群を提供します。
pyenv-win: Windows で pyenv 的な機能を提供する別ツール（またはラッパー）。Windows 環境で Python バージョンを管理したいときに使います。
pyenv init: シェルに pyenv の初期化処理を組み込むコマンド。PATH の設定や shims の読み込みを有効化します。
pyenv local: カレントディレクトリに対して適用する Python バージョンを設定するコマンド。通常は .python-version ファイルに記録します。
pyenv global: システム全体で使われるデフォルトの Python バージョンを設定するコマンド。
pyenv shell: 現在のシェルだけに適用する一時的な Python バージョンを設定するコマンド。
pyenv install: 指定した Python バージョンをインストールするコマンド。例: pyenv install 3.9.7。
pyenv versions: インストール済みの Python バージョンと、pyenv-virtualenv で作成した仮想環境を一覧表示するコマンド。
pyenv version: 現在アクティブな Python バージョンと、それがどのスコープ(global/local/shell)かを表示するコマンド。
.python-version: pyenv local が参照するファイル。現在のディレクトリで使う Python バージョンを指定します。
shims: pyenv が作成する中継実行ファイルの集合。PATH に配置され、実行時に実際の Python へ振り分けます。
PYENV_ROOT: pyenv のルートディレクトリを指す環境変数。インストール先や shims などが格納されます。
PATH: 実行ファイルを探す場所を示す環境変数。pyenv はこの PATH に shims を置くことで動作します。
activate: 仮想環境を有効化するためのコマンド。環境内の Python とパッケージを現在のシェルで使えるようにします。
deactivate: 現在の仮想環境を無効化して、元の環境へ戻すコマンド。
pip: 仮想環境内で使う Python パッケージ管理ツール。環境ごとに依存関係を分離して管理します。
requirements.txt: Python プロジェクトの依存パッケージリストを記述したファイル。pip で一括インストールする際に使います。
pyproject.toml: 現代の Python プロジェクト設定ファイル。依存関係管理やビルドツールの設定に使われます。