WSL环境配置

2026-10-30

本机硬件：5060TI，WSL环境下配置Ubuntu 24.04 与 CUDA 12.8

安装步骤

第一步：在 Windows 上安装 WSL 2 以管理员身份打开 PowerShell运行如下命令，先只安装 WSL 组件、默认C盘，不包含 Linux 发行版（比如 Ubuntu），占用空间小

wsl --install --no-distribution

第二步：重启电脑后，从 Ubuntu 官网下载 WSL 专用镜像（.wsl 文件），放到D:\WSL\ 后续涉及ubuntu里面的安装就全在D盘了 https://releases.ubuntu.com/24.04.5/ubuntu-24.04.5-wsl-amd64.wsl

wsl --import Ubuntu-24.04 D:\WSL\Ubuntu-24.04 D:\WSL\ubuntu-24.04-wsl-amd64.wsl --version 2

装好后可以确认一下版本是否为 2 删除多余文件

wsl --list --verbose

第三步：重启电脑后，PowerShell运行如下命令

wsl -d Ubuntu-24.04

#root@DESKTOP-UNQ7M4:/mnt/c/Windows/System32 表面还没有创建用户创建普通用户，赋予权限，设为默认

adduser 你的用户名 
usermod -aG sudo 你的用户名
ubuntu2404 config --default-user 你的用户名

重新打开 Ubuntu，确认提示符从 root@ 变成了你的用户名@，就成功了

第四步：在 WSL 里安装 CUDA Toolkit 先验证显卡是否已透传

nvidia-smi

安装 WSL 专用 CUDA Toolkit 12.8，/mnt/c/Users/WXZ 是 Windows 的 C 盘用户目录，不建议在这里运行 CUDA Toolkit 的安装命令

cd ~
wget https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/cuda-keyring_1.1-1_all.deb
sudo dpkg -i cuda-keyring_1.1-1_all.deb
sudo apt update
sudo apt install -y cuda-toolkit-12-8

安装完成后，把 CUDA 路径加到环境变量里，并验证，看到版本号 12.8 就说明已装好，删除多余文件：

echo 'export PATH=/usr/local/cuda/bin:$PATH' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=/usr/local/cuda/lib64:$LD_LIBRARY_PATH' >> ~/.bashrc
source ~/.bashrc
nvcc --version
rm cuda-keyring_1.1-1_all.deb

第五步：在 WSL (Ubuntu) 里安装 Anaconda，一路yes 看到 (base) 前缀就成功了，默认python 3.13.5，删除多余文件

wget https://repo.anaconda.com/archive/Anaconda3-2025.06-1-Linux-x86_64.sh
bash Anaconda3-2025.06-1-Linux-x86_64.sh
rm Anaconda3-2025.06-1-Linux-x86_64.sh

第六步：创建虚拟环境安装 PyTorch，默认3.11.18

conda create -n dl python=3.11 -y
conda activate dl
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu128
python -c "import torch; print(torch.cuda.is_available(), torch.cuda.get_device_name(0))"
python -c "import torch; x = torch.rand(1000, 1000).cuda(); y = x @ x; print(y.mean().item())"

第七步：创建文件夹放代码和数据，Windows 的文件资源管理器 \wsl.localhost\Ubuntu-24.04\home\wxz\datasets

mkdir -p ~/projects
mkdir -p ~/datasets

如果 \wsl.localhost 路径无法访问，可以退一步：先在 Windows 里把 U 盘的数据集拷贝到你之前建的 D:\datasets（或者任意 D 盘目录），然后在 WSL 里用 cp 命令从 /mnt/d/datasets 复制到 ~/datasets。

第八步：其他开发软件安装 git ，在 WSL 里执行即可

sudo apt install git

Vim使用说明

vim ~/.bashrc 普通模式打不了字，在普通模式下（按 Esc 回到普通模式），输入 G（大写，即 Shift + g）可以直接跳到文件最后一行。进入插入模式：按键盘上的 i 键。左下角会出现 – INSERT – 字样，表示现在可以打字了。先按 Esc 退出插入模式。输入 :wq（冒号、w、q），然后回车。w 是保存，q 是退出。如果不想保存、直接退出，输入 :q! 回车。