Python 仮想環境を作成してアクティブ化する方法

組み込みの venv モジュールを使用して Python 仮想環境を作成、アクティブ化、管理する方法を学びます。プロジェクトの依存関係を分離してクリーンな状態に保ちます。

概要

Python アプリケーションを開発する場合、pip を使用してサードパーティのパッケージをインストールすることがよくあります。仮想環境を使用しない場合、これらのパッケージはシステムの Python 環境にグローバルにインストールされます。これは、異なるプロジェクトが同じライブラリの異なるバージョンを必要とする場合 (たとえば、プロジェクト A にはDjango3.2 が必要で、プロジェクト B にはDjango5.0 が必要です) に、すぐに競合が発生する可能性があります。

仮想環境は、独自の Python 実行可能ファイルと独自のインストール済みパッケージのセットを含む分離されたディレクトリです。プロジェクトごとに仮想環境を作成することで、パッケージのインストールが他のプロジェクトやシステム全体の Python セットアップに干渉しないようにします。これは、Python 開発の基本的なベストプラクティスです。

最新のPython 3の標準ライブラリには、外部ツールを必要とせずに仮想環境を処理する `venv` モジュールが含まれています。仮想環境のライフサイクルには、環境ディレクトリの作成、アクティブなターミナルセッションでのアクティブ化、依存関係のインストール、そして最終的に終了時の非アクティブ化が含まれます。

コードと実行の出力

このシミュレーションでは、macOS/Linux および Windows での仮想環境の作成、アクティブ化、パッケージのインストール、および非アクティブ化に使用されるターミナルコマンドを表示します。

virtual_env.py

エディターで試してみる

commands_macos_linux = """
# 1. Create a virtual environment named 'venv'
$ python3 -m venv venv

# 2. Activate the virtual environment
$ source venv/bin/activate

# 3. Verify activation (will show the path to the virtual env's python)
(venv) $ which python

# 4. Deactivate when done
(venv) $ deactivate
"""

commands_windows = """
# 1. Create a virtual environment named 'venv'
> python -m venv venv

# 2. Activate the virtual environment in Command Prompt
> venv\Scripts\activate

# 3. Or activate in PowerShell
> .\venv\Scripts\Activate.ps1

# 4. Deactivate when done
(venv) > deactivate
"""

print("macOS & Linux terminal commands:")
print(commands_macos_linux.strip())
print("\nWindows terminal commands:")
print(commands_windows.strip())

端子出力

macOS & Linux terminal commands:
# 1. Create a virtual environment named 'venv'
$ python3 -m venv venv

# 2. Activate the virtual environment
$ source venv/bin/activate

# 3. Verify activation (will show the path to the virtual env's python)
(venv) $ which python

# 4. Deactivate when done
(venv) $ deactivate

Windows terminal commands:
# 1. Create a virtual environment named 'venv'
> python -m venv venv

# 2. Activate the virtual environment in Command Prompt
> venv\Scripts\activate

# 3. Or activate in PowerShell
> .\venv\Scripts\Activate.ps1

# 4. Deactivate when done
(venv) > deactivate

段階的な実装

プロジェクトターミナルで python -m venv <env_name> を実行して、環境ファイルを生成します。
source <env_name>/bin/activate (macOS/Linux) または <env_name>\Scripts\activate (Windows) を使用して環境をアクティブ化します。
pip install を使用して必要なパッケージをインストールし、それらがこのプロジェクトディレクトリに確実に分離されるようにします。
作業が終了したら、ターミナルシェルで「deactivate」と入力し、仮想環境を終了します。