文章目錄
- 1 安裝 wsl
- 1.1 開啟 Windows 支持
- 1.2 安裝 wsl
- 1.3 移動 wsl 至其他盤
- 1.4 其他事項
- 2 安裝 Anaconda
- 3 安裝 Python 環境
- 3.1 創建 Conda 環境
- 3.2 安裝 Pytorch 庫(gpu)
- 4 安裝 Pycharm
- 4.1 Toolbox App 安裝
- 4.2 安裝 Pycharm
- 4.3 配置 Pycharm
- 5 測試驗證
本文配置:
- win11 + wsl2 + Ubuntu24.04
- Pycharm 2025.1.2
- Python3.13 + Pytorch2.7.1 + cu128
1 安裝 wsl
1.1 開啟 Windows 支持
-
打開 windows 菜單,搜索“控制面板”并打開。
-
點擊“程序”
->
“啟用或關閉 Windows 功能”。 -
勾選以下選項,并點擊確定。
- Hyper-V(WSL 基于此功能工作,win11 家庭版沒有該選項,安裝步驟見后文)
- Windows 虛擬機監控程序平臺(也稱“虛擬機平臺”,若出現也需勾選)
- 適用于 Linux 的 Windows 子系統
-
確定完成后,需重啟系統才能生效。
? Win11 專業版提供了 Hyper-V 功能,但 Win/11 家庭版卻沒有該功能。
? Win/11 家庭版安裝 Hyper-V 參考安裝鏈接如下:
- Win10/Win11家庭版安裝Hyper-V - 知乎
- Win11家庭版安裝Hyper-V-CSDN博客
1.2 安裝 wsl
-
打開 windows 菜單,搜索“Windows PowerShell”并打開,輸入如下命令驗證是否安裝成功。
wsl
-
提示需要更新 wsl,繼續輸入如下命令進行更新。
wsl --update
-
輸入如下命令查看 wsl 支持的 Linux 版本。
wsl --list --online
-
選擇需要安裝的發行版,輸入命令格式如下。本文使用 Ubuntu-24.04:
wsl --install -d <DistributionName>
DistributionName
:Linux 系統的名稱。
這里需要保持網絡通暢,建議不開梯子直接下載。
-
安裝完成后,提示需要創建用戶,這里輸入你的用戶名與密碼。
輸入完成后,默認進入 Ubuntu 系統中。
-
輸入如下命令,退出 Ubuntu 系統:
exit
1.3 移動 wsl 至其他盤
? wsl 默認安裝在 C 盤,最好移動到其它盤。
-
輸入如下命令,導出系統鏡像。
wsl --export <DistributionName> <ExportPath>
DistributionName
:Linux 系統名稱。ExportPath
:導出的文件路徑。
-
依次輸入如下命令,先注銷原有的 Linux 系統,再重新導入并指定存放位置。
wsl --unregister <DistributionName>wsl --import <DistributionName> <ExportPath> <ImportPath>
DistributionName
:Linux 系統名稱。ExportPath
:導出的文件路徑。ImportPath
:重新存放的路徑。
? 操作完成后,Linux 系統映像文件存儲到了 E 盤,并創建了一個 ico 圖標文件。

1.4 其他事項
-
直接啟動
在 win 菜單下輸入 Ubuntu 即可直接啟動:
-
文件互訪
-
WSL
->
Windows在 /mnt 路徑下可訪問 Windows 盤。
-
Windows
->
WSL打開文件資源管理器,點擊 Linux 小企鵝圖標即可訪問 WSL 文件系統。
-
-
其他常用命令
- win 下:
wsl
:進入 Linux 子系統。wsl -l -v
:查看已安裝的 Linux 狀態和版本。wsl --shutdown
:終止所有正在運行的 Linux。
- wsl 下:
exit
:退出當前子系統。
- win 下:
-
網絡通信
因為網絡問題,在 WSL2 中配環境時通常會非常緩慢甚至失敗,這是因為 wsl 默認采用 NAT 模式。
在開始菜單中搜索“WSL Settings”,在“網絡”
->
“網絡模式”處選擇“Mirrored”即可。相關參考鏈接:在 WSL2 中使用 Clash for Windows 代理連接 - East Monster 個人博客。
2 安裝 Anaconda
-
進入 Anaconda 下載官網:Download Now | Anaconda。右鍵 Linux 的 Installer 選項,選擇“復制鏈接”。
這里選擇安裝 Miniconda。
-
進入 wsl,輸入如下命令安裝 Miniconda:
wget <CopyLink>
CopyLink
:步驟 1 中復制的鏈接。
-
輸入命令
ls
,查看當前目錄下已經下載 .sh 文件。輸入以下命令開始安裝,并按回車確定。sh <FileName>
FileName
:下載的文件名。
-
輸入“yes”同意使用條款。
-
接下來選擇安裝路徑,可以輸入指定安裝路徑。直接回車使用默認路徑即可。
-
輸入“yes”回車,這將使 conda 自動修改你的 shell 配置文件,以便在終端啟動時自動激活 conda 環境。
到此,Miniconda 安裝完成。
3 安裝 Python 環境
3.1 創建 Conda 環境
-
重啟 wsl,使得進入時擁有 conda 環境。
-
輸入以下命令,創建 DL(DeepLearning) 環境,這里指定 Python 版本為 3.13。
conda create -n DL python=3.13
-
輸入以下命令,進入 DL 環境。
conda activate DL
3.2 安裝 Pytorch 庫(gpu)
-
運行以下命令,查看本機所支持的最大 CUDA 版本,本文是 12.9。
nvidia-smi
-
進入 Pytorch 官網:Get Started,選擇對應的 Pytorch 版本,復制命令行。
? 注意 CUDA 版本不要超過步驟 1 中本機所支持的最大版本。例如,本文電腦 CUDA 最高支持 12.9 版本,因此選擇一個低于 12.9 版本的即可。
本文所選的配置如下:
-
將步驟 2 中復制的命令行粘貼到 wsl 中回車運行,等待安裝。
現在,安裝 Pytorch 庫時,會自動下載包含 CUDA 和 cuDNN 的預編譯包,因此不用手動安裝。
-
輸入
Python
命令進入 Python 環境,依次運行下面 2 行代碼:import torchtorch.cuda.is_available()
輸出結果為 True,則安裝成功。
4 安裝 Pycharm
4.1 Toolbox App 安裝
-
進入 Jetbrains 官網:https://www.jetbrains.com.cn/,點擊 Toolbox App 下載并安裝。該軟件只能安裝在 C 盤,因此安裝時一路同意即可。
-
打開 Toolbox App,點擊進入設置
-
在“工具”一欄設置 Pycharm 安裝路徑。
4.2 安裝 Pycharm
-
返回 App,選擇 Pycharm 安裝。
-
下載完成后,點擊 Pycharm,選項默認即可。
4.3 配置 Pycharm
-
進入左側欄“遠程開發”,選擇“WSL”,點擊“新建項目”。
-
Pycharm 自動識別 WSL,點擊“下一頁”。
-
Pycharm 會在 wsl 中下載一個客戶端進行遠程通信,此選項建議:
-
IDE 版本:
選擇穩定版,不選 EAP 版本。
-
項目目錄:
在用戶目錄下新建目錄 python_project 用于存放所有 python 項目,并在其下新建一個文件夾作為當前項目。
配置完成后,點擊“下載 IDE 并鏈接”(注意開啟 wsl)。
-
-
重新配置 wsl 中的 Pycharm。
-
進入項目后,看見左上角有 Linux 子系統名稱標識遠程連接。
-
進入“設置”
->
“項目:你的項目”->
“Python 解釋器”,點擊右側“添加解釋器”->
“添加本地解釋器”。 -
依次選擇如下:
- 環境:選擇現有。
- 類型:Conda。
- Conda 路徑:已自動識別。
- Conda 環境:DL。
點擊確定后,到此環境已配置完成。
5 測試驗證
-
修改 “main.py” 文件,內容如下:
# This is a sample Python script.# Press Shift+F10 to execute it or replace it with your code. # Press Double Shift to search everywhere for classes, files, tool windows, actions, and settings.import torch# Press the green button in the gutter to run the script. if __name__ == '__main__':print(torch.__version__)print(torch.cuda.is_available())# See PyCharm help at https://www.jetbrains.com/help/pycharm/
-
運行,得到 torch 版本為 2.7.1+cu128,且輸出 True,則環境配置成功!