【Python】venvでバージョン指定した仮想環境をLinux上に構築する方法

公開：2025年4月18日更新：2026年4月6日

CodeCampが提供するDX人材育成が可能なプログラミングやITが学べる公開講座

Linuxにバージョン指定したPythonの仮想環境(venv)を構築する方法
venv環境でパッケージのバージョンを指定する方法
既存のvenv環境のPythonバージョンを変更する方法

Linuxにバージョン指定したPythonの仮想環境(venv)を構築する方法

Linuxでは、pythonのvenvモジュールを使うことで特定のバージョンのPythonで仮想環境を構築できます。この方法では、システムのPythonに影響を与えることなく、プロジェクトごとに独立した環境を作成できます。ベースとなるPythonをフルパスで指定することで、使用したいバージョンの仮想環境をセットアップできます。

仮想環境を作成するには、まず使用したいPythonバージョンがインストールされていることを確認する必要があります。Ubuntu系であれば、必要なバージョンのPythonとvenvパッケージをaptコマンドでインストールできます。例えば、Python 3.9を使用したい場合はsudo apt install -y python3.9 python3.9-venvのように実行します。

特定のバージョンで仮想環境を作成する際は、そのバージョンの実行ファイルを明示的に指定することが重要です。作成された仮想環境のPythonバージョンは、環境作成時に指定したバージョンで固定されます。

【サンプルコード】
# 特定のバージョンでvenv環境を作成
/usr/bin/python3.9 -m venv myproject_env

# 仮想環境をアクティブ化
source myproject_env/bin/activate

# バージョン確認
python --version

Python研修一覧はこちら

目的に合うPython研修を一覧形式から探したい方は、ぜひご利用ください。

Python研修を比較する

Java研修一覧はこちら

目的に合うJava研修を一覧形式から探したい方は、ぜひご利用ください。

Java研修を比較する

PHP研修一覧はこちら

目的に合うPHP研修を一覧形式から探したい方は、ぜひご利用ください。

PHP研修を比較する

新入社員研修

目的に合う新入社員研修を一覧形式から探したい方は、ぜひご利用ください。

新入社員研修を比較する

全ての研修からも探したい方はこちら

venv環境でパッケージのバージョンを指定する方法

venv環境内でパッケージをインストールする際にも、バージョン指定子を使ってパッケージの特定バージョンを指定できます。この方法により、プロジェクトの依存関係を正確に管理できます。バージョン指定をしない場合はコマンド実行時の最新バージョンが取得されますが、バージョン差異によるエラーを防ぐために、すべてのモジュールのバージョンを指定することが推奨されています。

要件ファイル（requirements.txt）を作成して使用することで、複数のパッケージとそのバージョンを一度に管理できます。これにより、環境の再現性が高まり、他の開発者と同じ環境を共有しやすくなります。また、プロジェクトの依存関係をコード管理システムで追跡することも容易になります。

個々のパッケージをインストールする場合も、バージョンを明示することでプロジェクト全体の安定性が向上します。バージョンピン留めにより、予期せぬ変更や互換性の問題を回避できるため、本番環境での運用には特に重要です。

【サンプルコード】
# requirements.txtの作成例
echo "numpy==1.21.0
pandas==1.3.5
matplotlib==3.5.1" > requirements.txt

# requirements.txtからパッケージをインストール
pip install -r requirements.txt

# 個別にバージョン指定してインストール
pip install requests==2.28.1

既存のvenv環境のPythonバージョンを変更する方法

venvで作成した仮想環境のPythonバージョンを変更したい場合、その環境は作成時のローカルのバージョンで固定されているため、単純に切り替えることはできません。バージョンを変更するには、--clearオプションを使用して仮想環境を一度クリアする必要があります。

この方法では、まずローカル環境のPythonを変更したいバージョンに切り替え、次に既存の仮想環境をクリアします。この操作により、仮想環境内のPythonバージョンを更新できますが、以前にインストールしたパッケージはすべて失われるため、再インストールが必要になります。

大規模なプロジェクトでは、パッケージの再インストールが面倒な場合があります。その際は、requirements.txtファイルを事前に作成しておくと、環境再構築が容易になります。これにより、Pythonバージョンの変更後も同じパッケージ構成を簡単に復元できます。

【サンプルコード】
# 既存のパッケージリストを保存
pip freeze > requirements.txt

# 仮想環境をdeactivate
deactivate

# 仮想環境をクリア（Pythonバージョンを変更）
/usr/bin/python3.10 -m venv myproject_env --clear

# 仮想環境を再度アクティブ化
source myproject_env/bin/activate

# パッケージを再インストール
pip install -r requirements.txt

※上記コンテンツの内容やソースコードはAIで確認・デバッグしておりますが、間違いやエラー、脆弱性などがある場合は、コメントよりご報告いただけますと幸いです。