Python 仮想環境
（venv）の使い方

Python の 仮想環境（virtual environment） とは、プロジェクトごとに独立した Python 環境を作る仕組みです。

なぜ仮想環境が必要なの？

例えば、プロジェクト A では Flask 2.0、プロジェクト B では Flask 3.0 を使いたい場合、グローバル環境には 1 つしかインストールできません。仮想環境を使えばプロジェクトごとに異なるバージョンを管理できます。

• プロジェクト間のパッケージ競合を防ぐ
• 本番環境と同じパッケージ構成を再現できる
• パソコン全体の Python 環境を汚さない

プロジェクトのフォルダ内で以下のコマンドを実行します。

# プロジェクトフォルダを作成して移動
mkdir my-project
cd my-project

# 仮想環境を作成（フォルダ名は "venv" が慣習）
python -m venv venv

# プロジェクトフォルダを作成して移動
mkdir my-project
cd my-project

# 仮想環境を作成
python3 -m venv venv

コマンドを実行すると venv/ フォルダが作成されます。このフォルダの中に独立した Python 環境が格納されます。

my-project/
├── venv/          ← 仮想環境フォルダ（中身は触らない）
│   ├── bin/       （Mac/Linux）または Scripts/ （Windows）
│   ├── lib/
│   └── pyvenv.cfg
├── main.py
└── requirements.txt

仮想環境を作成したら、必ず有効化してから使います。有効化しないと、グローバル環境にパッケージがインストールされてしまいます。

.\venv\Scripts\Activate.ps1

(venv) PS C:\Users\user\my-project>

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

deactivate

source venv/bin/activate

(venv) user@mac my-project %

deactivate

仮想環境を有効化した状態で pip install すると、その仮想環境だけにパッケージがインストールされます。

# 仮想環境を有効化してから実行
(venv) $ pip install flask

# インストール済みパッケージを確認
(venv) $ pip list
Package    Version
---------- -------
Flask      3.0.3
Werkzeug   3.0.3
...

# pip 自体を最新版に更新しておくと安心
(venv) $ pip install --upgrade pip

requirements.txt は、インストールしたパッケージとバージョンを記録するファイルです。チームメンバーや本番環境でも同じ環境を再現できます。

requirements.txt を作成する

# 現在の仮想環境のパッケージをファイルに書き出す
(venv) $ pip freeze > requirements.txt

# ファイルの中身を確認
(venv) $ cat requirements.txt
blinker==1.8.2
click==8.1.7
Flask==3.0.3
itsdangerous==2.2.0
Jinja2==3.1.4
MarkupSafe==2.1.5
Werkzeug==3.0.3

requirements.txt からインストールする

他の環境で同じパッケージ群をインストールするときは -r オプションを使います。

# 仮想環境を作成して有効化した後
(venv) $ pip install -r requirements.txt

venv/ フォルダは Git で管理する必要がありません。.gitignore に追記しておきましょう。

# .gitignore ファイルに追記
venv/
__pycache__/
*.pyc
.env
instance/