WSL (Windows Subsystem for Linux)#

WSL（Windows Subsystem for Linux）是 Windows 的兼容层，允许在 Windows 上直接运行 Linux 二进制文件。WSL2 基于真实的 Linux 内核，提供完整的系统调用兼容性，适合开发、测试和运行 Linux 应用。

安装#

# 安装 WSL 和 Ubuntu
wsl --install Ubuntu

# 指定安装位置
wsl --install Ubuntu --location F:\\wsl\\Ubuntu

# 启动进入 WSL
wsl

# 查看已安装的发行版
wsl --list --verbose
wsl -l -v

# 关闭 WSL
wsl --shutdown

常用命令#

命令	说明
`wsl`	启动默认发行版
`wsl -d <发行版名>`	启动指定发行版
`wsl --list`	列出已安装发行版
`wsl --shutdown`	关闭所有 WSL 实例
`exit`	退出 WSL

官方文档：Basic Commands

迁移安装位置#

# 迁移 Ubuntu 到新位置
wsl --manage Ubuntu --move F:\\wsl\\Ubuntu

CUDA 支持#

Win11 WSL2 默认支持 CUDA，无需额外配置。

参考：CUDA on WSL

# 测试 CUDA
nvidia-smi

# PyTorch 测试
python3 -c "import torch; print(torch.cuda.is_available()); print(torch.version.cuda); print(torch.cuda.device_count()); print(torch.cuda.get_device_name(0))"

Docker GPU 支持#

⚠️ 注意: WSL2 中 Docker 容器 GPU 映射可能存在问题，需安装 nvidia-container-toolkit。

# Docker 安装
sudo snap install docker

# Docker 测试 GPU
docker run --rm --gpus all nvidia/cuda:12.0-base nvidia-smi

环境配置#

网络代理#

WSL2 中通过 Windows 主机代理上网（主机 IP 通常为 172.18.112.1）：

export http_proxy=http://172.18.112.1:7890
export https_proxy=http://172.18.112.1:7890

Python 配置#

# 激活虚拟环境
source ~/py/base/bin/activate

# pip 使用清华源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 查看 pip 配置
pip config list

常见问题#

虚拟化未启用#

错误: 虚拟机无法启动 (Error 0x80370102)

解决: 1. 通过任务管理器检查 CPU 虚拟化是否启用 2. 进入 BIOS 启用虚拟化 3. 启用 Windows 功能（管理员 PowerShell）：

Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -All -NoRestart

参考：WSL Troubleshooting