Pythonの仮想環境をバックアップ及びリストア

忘れないようにメモしておきます。これは、Gemini2.5の問い合わせ結果です。
良い時代になりましたね。

Pythonの仮想環境をバックアップする際、最も重要で推奨される方法は、仮想環境のフォルダ（例: venv）を直接コピーすることではありません。

フォルダを直接コピーすると、PCの環境（OS、フォルダのパス、Pythonのバージョン）に依存する情報が含まれているため、別のPCや別の場所で再利用しようとすると、ほぼ確実に動作しなくなります。

正しいアプローチは、「インストールされているパッケージのリストを保存し、そのリストを元に新しい環境を再現する」ことです。これにより、クリーンでポータブルな環境の「設計図」をバックアップできます。

これはPython開発における最も標準的でベストプラクティスとされている方法です。

現在アクティブな仮想環境にインストールされているパッケージとそのバージョンの一覧を requirements.txt というファイルに保存します。

仮想環境をアクティベート（有効化）します。
Bash
```
# macOS / Linux
source venv/bin/activate

# Windows (コマンドプロンプト)
venv\Scripts\activate
```
ターミナルの行頭に (venv) のような表示が出ていることを確認してください。
pip freeze コマンドでパッケージ一覧をファイルに出力します。
Bash
```
(venv) $ pip freeze > requirements.txt
```
このコマンドを実行すると、プロジェクトのフォルダにrequirements.txtというファイルが作成されます。

requirements.txtの中身（例）:
```
beautifulsoup4==4.12.3
certifi==2024.6.2
charset-normalizer==3.3.2
idna==3.7
numpy==1.26.4
pandas==2.2.2
python-dateutil==2.9.0.post0
pytz==2024.1
requests==2.32.3
six==1.16.0
soupsieve==2.5
urllib3==2.2.1
```
このファイルが仮想環境の「バックアップ」となります。非常に軽量で、どんな環境にも持ち運べます。

別のPCや、環境を作り直したい場所で、保存したrequirements.txtを使って環境を再現します。

新しい仮想環境を作成し、アクティベートします。

Bash

# 新しい仮想環境を作成
python -m venv new_venv

# 新しい環境をアクティベート
# macOS / Linux
source new_venv/bin/activate
# Windows
new_venv\Scripts\activate

pip install コマンドで requirements.txt から全パッケージをインストールします。
Bash
```
(new_venv) $ pip install -r requirements.txt
```
pipがrequirements.txtを読み込み、記載されているバージョンのパッケージを自動的にすべてインストールしてくれます。

これで、バックアップ作成時と全く同じパッケージ構成の仮想環境が再現されます。

実際のアプリケーション開発では、PoetryやPipenvといった、より高機能なツールが使われることも多いです。これらのツールは、依存関係の解決や仮想環境の管理をさらに厳密に行ってくれます。

Poetry: pyproject.tomlファイルで依存関係を定義し、poetry.lockファイルでバージョンを固定します。このpyproject.tomlとpoetry.lockがバックアップ対象になります。
Pipenv: PipfileとPipfile.lockというファイルで同様の管理を行います。

これらのツールを使っている場合は、それぞれのツールが生成する設定ファイル（pyproject.toml, Pipfile.lockなど）をGitで管理・バックアップするのが一般的です。

前述の通り、venvフォルダをzipで圧縮したり、そのままコピーしたりする方法は以下の理由で推奨されません。

パスの非互換性: 仮想環境内のスクリプトには、作成された場所の絶対パスがハードコード（直書き）されているため、場所を移動すると動作しません。
OS・Pythonバージョンの非互換性: Windowsで作成した環境はLinuxでは使えません。また、Python 3.9で作成した環境をPython 3.11しかないPCで使おうとしても動作しません。
ファイルサイズが大きい: インストールした全パッケージのファイルやPython本体のコピーが含まれるため、バックアップファイルのサイズが非常に大きくなります。

方法	手法	メリット	デメリット	こんな時に
推奨	`pip freeze > requirements.txt`	軽量、ポータブル（OS等に依存しない）、業界標準、再現性が高い	–	個人・チーム開発の標準的なバックアップ、環境共有
非推奨	フォルダを直接コピー/圧縮	見た目上はシンプル	動作しない、ファイルサイズが大きい、移植性がない	基本的に行うべきではない

Python仮想環境のバックアップとは、**「環境そのものではなく、環境を再現するためのレシピ（requirements.txt）を保存すること」**と覚えておくのが最も確実です。