目的：Python 実行環境の構築
元々はWindows10環境下にてPythonを使っていましたが、新規PCへの移行に伴い、環境構築をすることになりました。
せっかくなのでPandasの高速化（？）ライブラリであるfireducksなどを使用してみたく、今回の内容を実施しました。
使うもの
- Windows10
- WSL2
- Linux
- Ubuntu-24.04
- Python
- 3.7~3.13
- VisualStudioCode
- 1.91.1
1. WSL2のインストール
- 管理者権限でPowerShellを開く
- 以下のコマンドを実行してWSLをインストールする
wsl --install
- コンピューターを再起動する。
- 再起動後、Ubuntuが自動的に起動する
- ユーザー名とパスワードを設定する
- パスワード入力時、画面には表示されない
WSLが起動できない場合
- WSLで規定のディストリビューションを確認する
- 規定のディストリビューションがUbuntuなどでは無い可能性がある（[ docker-desktop-data ]などはWSLから起動できない）
wsl --status
- 表示されたディストリビューションを控える
- 規定のディストリビューションを[ Ubuntu-24.04 ]に変更する
- ディストリビューションのインストール
wsl --install Ubuntu-24.04
- ユーザー名とパスワードを設定する
- パスワード入力時、画面には表示されない
- 規定のディストリビューションを終了する
wsl --terminal [ 規定されていたディストリビューション ]
- 規定のディストリビューションを指定する
wsl --set-default Ubuntu-24.04
起動できなかった時のログ↓
PS C:\Users\'ユーザー名'> wsl
<3>WSL (10) ERROR: CreateProcessParseCommon:711: Failed to translate C:\Users\'ユーザー名'
<3>WSL (10) ERROR: CreateProcessParseCommon:757: getpwuid(0) failed 2
<3>WSL (10) ERROR: UtilTranslatePathList:2866: Failed to translate C:\Windows\system32
<3>WSL (10) ERROR: UtilTranslatePathList:2866: Failed to translate C:\Windows
<3>WSL (10) ERROR: UtilTranslatePathList:2866: Failed to translate C:\Windows\System32\Wbem
<3>WSL (10) ERROR: UtilTranslatePathList:2866: Failed to translate C:\Windows\System32\WindowsPowerShell\v1.0\
<3>WSL (10) ERROR: UtilTranslatePathList:2866: Failed to translate C:\Windows\System32\OpenSSH\
<3>WSL (10) ERROR: UtilTranslatePathList:2866: Failed to translate C:\Program Files\Common Files\Autodesk Shared\
<3>WSL (10) ERROR: UtilTranslatePathList:2866: Failed to translate C:\Program Files\Microsoft SQL Server\150\Tools\Binn\
<3>WSL (10) ERROR: UtilTranslatePathList:2866: Failed to translate C:\Program Files\dotnet\
<3>WSL (10) ERROR: UtilTranslatePathList:2866: Failed to translate C:\Program Files\Common Files\Autodesk Shared\Advance\
<3>WSL (10) ERROR: UtilTranslatePathList:2866: Failed to translate C:\Program Files (x86)\Common Files\Autodesk Shared\Advance\
<3>WSL (10) ERROR: UtilTranslatePathList:2866: Failed to translate C:\Program Files\Git\cmd
<3>WSL (10) ERROR: UtilTranslatePathList:2866: Failed to translate C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit\
<3>WSL (10) ERROR: UtilTranslatePathList:2866: Failed to translate C:\Program Files\Docker\Docker\resources\bin
<3>WSL (10) ERROR: UtilTranslatePathList:2866: Failed to translate C:\Users\'ユーザー名'\AppData\Local\Microsoft\WindowsApps
<3>WSL (10) ERROR: UtilTranslatePathList:2866: Failed to translate C:\Users\'ユーザー名'\AppData\Local\Programs\Microsoft VS Code\bin
Processing fstab with mount -a failed.
Failed to mount C:\, see dmesg for more details.
Failed to mount D:\, see dmesg for more details.
<3>WSL (10) ERROR: CreateProcessEntryCommon:334: getpwuid(0) failed 2
<3>WSL (10) ERROR: CreateProcessEntryCommon:505: execvpe /bin/sh failed 2
<3>WSL (10) ERROR: CreateProcessEntryCommon:508: Create process not expected to return
2. UbuntuでPython環境の設定
2.1. Ubuntuターミナルで以下のコマンドを順次実行し、必要なパッケージをインストールする
sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt upgrade
sudo apt update
sudo apt upgrade
sudo apt update
2.2. Pythonの各Versionのインストール
- 必要なバージョンのみ順次実行
sudo apt install python3.7 python3.7-venv python3.7-dev
sudo apt install python3.8 python3.8-venv python3.8-dev
sudo apt install python3.9 python3.9-venv python3.9-dev
sudo apt install python3.10 python3.10-venv python3.10-dev
sudo apt install python3.11 python3.11-venv python3.11-dev
sudo apt install python3.12 python3.12-venv python3.12-dev
sudo apt install python3.13 python3.13-venv python3.13-dev
2.3. 利用可能なPython Versionの確認
$ ls /usr/bin/python3*
実行結果
/usr/bin/python3 /usr/bin/python3.12 /usr/bin/python3.7-config /usr/bin/python3.9
/usr/bin/python3.10 /usr/bin/python3.12-config /usr/bin/python3.7m /usr/bin/python3.9-config
/usr/bin/python3.10-config /usr/bin/python3.13 /usr/bin/python3.7m-config
/usr/bin/python3.11 /usr/bin/python3.13-config /usr/bin/python3.8
/usr/bin/python3.11-config /usr/bin/python3.7 /usr/bin/python3.8-config
2.4. Pipのインストール
python3.13 get-pip.py
2.5. 仮想環境の作成
- python[ 適用したいバージョン ] -m venv ~/[ 環境名 ]
python3.7 -m venv ~/python3.7-env
python3.8 -m venv ~/python3.8-env
python3.9 -m venv ~/python3.9-env
python3.10 -m venv ~/python3.10-env
python3.11 -m venv ~/python3.11-env
python3.12 -m venv ~/python3.12-env
python3.13 -m venv ~/python3.13-env
2.6. 仮想環境のアクティベート
$ source ~/python3.12-env/bin/activate
(python3.12-env) $
2.7. 仮想環境のディアクティベート
- [ deactivate ]
(python3.12-env) $ deactivate
3. Visual Studio Codeのインストールと設定
3.1. VisualStudioCodeのインストール
- URLにアクセスし、OSを選択
- ダウンロード完了後インストール
3.2. VisualStudioCode拡張機能のインストール
- Linux上で VisualStudioCode 及び Pythonを動作させるため拡張機能をインストールする
- 画面左のアイコンの拡張機能をクリック
- 検索窓に下記を入力し、それぞれインストールする
- Python
- WSL
- Remote Development
4. VisualStudioCodeにおけるLinux仮想環境のパス設定
4.1. 仮想環境のパス取得
- アクティベートされた仮想環境にて[ which python ]でパスを取得
$ which python
/home/'ユーザー名'/python3.12-env/bin/python
4.2.仮想環境のパス設定
- VisualStudioCodeでコマンドパレット[ Ctrl+Shift+P ]を起動
- [ Remote-WSL: New Window ]を選択し、WSL環境に接続する
- 再びVisualStudioCodeでコマンドパレット[ Ctrl+Shift+P ]を起動
- [ Python: Select Interpreter ]を選択する
- 4.1.で取得した仮想環境のパス（/home/ユーザー名/python[ 任意のバージョン ]-env/bin/python）を選択
5. Pythonコードの実行テスト
- 構築した仮想環境が動作しているかテストする
- WSLに接続したVSCode内で新しいPythonファイル（例：test.py）を作成する
- 以下のようなサンプルコードを入力
print('WSL2 Python')
- ファイル名[ test.py ]で保存する
- [ python '実行するpythonファイル.py']コマンドで作成したサンプルコードを実行する
python test.py
- ターミナルに実行結果が表示されれば成功
WSL2 Python
おわりに
PC１台当たり２時間程度で作業完了できました。
今後はQiitaの投稿もしていけたらと思っています。