WSL2でPython,pip,venvをインストールして仮想環境を作成

WSL2 で Python の開発環境を整えた際の備忘録です。

参考サイト

Windows で Web 開発に Python を使用する | Microsoft Learn

Python, pip, venv をインストール

1. Linux ディストリビューションの更新（WSL2）

最新バージョンを使用するために、以下のコマンドで WSL2 のパッケージリストを更新し、パッケージを最新にします。

sudo apt update && sudo apt upgrade

コマンドの説明

• sudo apt update: パッケージリストを更新します
• sudo apt upgrade: インストール済みのパッケージを最新版に更新します
• &&: 前のコマンドが成功した場合のみ、次のコマンドを実行します

2. Python のインストール確認と更新

まず、Python3 がインストールされているか確認します。

python3 --version

実行例

Python 3.10.12

Python がインストールされていない場合は、以下のコマンドでインストールします。

sudo apt install python3

既にインストールされている場合は、以下のコマンドで最新版に更新します。

sudo apt upgrade python3

3. pip のインストール

pip とは

pip は Python のパッケージ管理ツールです。Python 標準ライブラリに含まれていない外部パッケージをインストール・管理するために使用します。

インストール手順

sudo apt install python3-pip

インストールが完了したら、以下のコマンドでバージョンを確認できます。

pip3 --version

4. venv のインストール

venv とは

venv は Python の仮想環境を作成するための標準モジュールです。仮想環境を使用することで、プロジェクトごとに異なるパッケージバージョンを管理できます。

インストール手順

sudo apt install python3-venv

仮想環境を作成

仮想環境とは

仮想環境は、プロジェクトごとに独立した Python の実行環境です。異なるプロジェクトで異なるバージョンのパッケージを使用する場合や、システムの Python 環境を汚さないために使用します。

仮想環境の作成手順

1. プロジェクト用のディレクトリを作成

仮想環境を作成するディレクトリを作成し、そのディレクトリに移動します。

mkdir sample && cd sample

コマンドの説明

• mkdir sample: sample という名前のディレクトリを作成します
• cd sample: sample ディレクトリに移動します

2. 仮想環境を作成

以下のコマンドで仮想環境を作成します。

python3 -m venv .venv

コマンドの説明

• python3 -m venv: venv モジュールを実行します
• .venv: 仮想環境の名前（先頭の . により、隠しディレクトリになります）

3. 作成されたディレクトリ構造

仮想環境が作成されると、以下のようなディレクトリ構造になります。

sample/
└─ .venv/  # ← 仮想環境が作成される

仮想環境のアクティブ化

アクティブ化とは

仮想環境をアクティブ化することで、その環境内の Python とパッケージが使用可能になります。アクティブ化中は、インストールするパッケージが仮想環境内にインストールされます。

アクティブ化の手順

以下のコマンドで仮想環境をアクティブ化します。

source .venv/bin/activate

アクティブ化の確認

アクティブ化に成功すると、コマンドプロンプトの前に (.venv) と表示されます。

実行例

# アクティブ化前
user@MY-PC:~$

# アクティブ化後
(.venv) user@MY-PC:~/sample$

注意事項

• 仮想環境をアクティブ化した状態で pip install を実行すると、パッケージは仮想環境内にインストールされます
• 新しいターミナルを開いた場合は、再度アクティブ化が必要です

仮想環境の非アクティブ化

非アクティブ化とは

仮想環境での作業が終了したら、仮想環境を非アクティブ化します。非アクティブ化すると、システムの Python 環境に戻ります。

非アクティブ化の手順

以下のコマンドで仮想環境を非アクティブ化します。

deactivate

実行例

# 非アクティブ化前
(.venv) user@MY-PC:~/sample$

# 非アクティブ化後
user@MY-PC:~/sample$

コマンドプロンプトの先頭から (.venv) が消えれば、非アクティブ化が完了しています。