Pythonモジュールを別のシステムにコピー・移行する方法【pip freezeの使い方】

はじめに

Pythonの開発環境を別のマシンに移したい場合、モジュール（パッケージ）の移行方法は大きく分けて2つのケースがあります。自分で作成したモジュールを移すケースと、pipなどでインストールした外部モジュールを移すケースです。それぞれ適切な方法を理解しておくと、環境構築の手間やトラブルを大幅に減らせます。

ケース1：自作モジュールをコピーする場合

自分で作成したPythonモジュール（.pyファイル）であれば、特別な手順は不要です。ファイルをそのままコピーし、Pythonがインストールされている別のシステム上に置けば、そのまま実行できます。

ケース2：インストール済みモジュールを移行する場合

pipでインストールした外部モジュールを移したい場合は、単純にフォルダごとコピーするのは避けましょう。OSやCPUアーキテクチャ、Pythonのバージョンの違いによって、動作しなかったりエラーが発生したりする可能性があります。

最も確実な方法は、まず移行先のシステムに同じバージョンのPythonをインストールすることです。そのうえで、以下の手順を実行します。

手順1：元のシステムでインストール済みモジュールの一覧を出力する

移行元のシステムで次のコマンドを実行すると、現在インストールされているすべてのモジュールとそのバージョン一覧が「installed_modules.txt」に出力されます。

$ pip freeze > installed_modules.txt

手順2：一覧ファイルを移行先のシステムへコピーする

作成した「installed_modules.txt」を、USBメモリやネットワーク経由など任意の方法で移行先のシステムへコピーします。

手順3：移行先のシステムでまとめてインストールする

移行先のシステムで、コピーしたファイルを指定してpipを実行します。

$ pip install -r installed_modules.txt

これにより、移行元のシステムにインストールされていたすべてのモジュールが、同じバージョンで自動的にインストールされます。

この方法が推奨される理由

モジュールのファイルを直接コピーアンドペーストする方法は、以下のような問題を引き起こす可能性があります。

• OSの違い（Windows / macOS / Linux）による互換性の問題
• CPUアーキテクチャの違い（x86 / ARMなど）によるバイナリの非互換
• Python本体のバージョン差異による動作不良

「pip freeze」と「pip install -r」を組み合わせた方法なら、依存関係も含めて正確に再現できるため、環境移行のベストプラクティスといえます。なお、仮想環境（venvなど）を使用している場合は、仮想環境を有効化した状態で上記のコマンドを実行すると、より安全に管理できます。