1. 这块需求到底是怎么回事:为什么要在WSL2里折腾CUDA
1.1 标题背后的典型使用场景
先说结论:如果你手头是一台Windows机器,又不想为了跑深度学习模型去装双系统或整台换成Linux,那WSL2几乎是目前最舒服的折中方案。标题里的“自用版”三个字很关键,说明这不是一篇面向服务器集群的部署文档,而是给个人开发者、研究生、算法工程师这类“我就想在本机赶紧把环境跑起来”的人准备的。
我碰到的实际场景是这样的:本机Windows 11,显卡是NVIDIA的,需要跑一些基于PyTorch的视觉模型,框架底层依赖CUDA。在Windows原生环境里,PyTorch对CUDA的支持虽然近几年好了很多,但很多老牌工具链、自定义算子、编译型扩展模块,在Linux环境下要顺滑得多。于是最自然的路径就是:Windows上开一个WSL2,装Ubuntu 22.04,再在Ubuntu里装CUDA 11.8。
这套组合之所以烂大街,是因为它兼顾了三个需求:日常办公和IDE留在Windows侧,深度学习训练跑在WSL2里,两边通过文件系统互相访问也算方便。而且WSL2不是虚拟机那种重资源方案,它共享Windows内核,启动快,内存和CPU的调度损耗低,用来跑中等规模的训练任务完全扛得住。
1.2 为什么选WSL2而不是双系统或纯Linux
很多人第一次知道WSL2时会问一个问题:既然都上Linux环境了,为什么不干脆装个双系统,或者直接换Ubuntu桌面?这个问题我每年都会被问几次,我的回答取决于对方的使用习惯。
如果你平时离不开Office全家桶、依赖微信和钉钉、要打游戏,或者公司强制要求使用Windows域环境,那双系统切换成本很高。每次重启切换系统既费时间又容易打断思路,更不用说双系统下显卡驱动、引导修复这些问题能把人折腾到怀疑人生。
WSL2的核心优势在于它是“Windows里的Linux子系统”,不需要重启,直接在Windows桌面上打开终端就能进入Ubuntu环境。对比传统虚拟机(比如VMware或VirtualBox),WSL2基于微软的轻量化虚拟化技术,底层跑的是真正的Linux内核,不是翻译层模拟,所以在CPU密集和I/O密集的任务上性能损耗非常小。GPU方面,WSL2支持GPU直通(GPU Passthrough),Linux侧可以直接调用Windows的NVIDIA驱动,这意味着CUDA程序在WSL2里跑,性能和原生Linux差距基本可以忽略。
当然也有不适合WSL2的场景:如果你要做内核模块开发、需要直接操作硬件设备、或者对GPU性能有极致的追求,那还是老老实实用原生Linux。但就“在Windows上跑PyTorch训练模型”这个典型需求来说,WSL2是目前综合体验最好的路线。
1.3 为什么锁定CUDA 11.8这个版本
先说清楚一个概念:我们常说的“安装CUDA”,实际上包含两个层面。一个是NVIDIA显卡驱动,这个驱动负责操作系统和GPU硬件之间的通信;另一个是CUDA Toolkit,这是一套开发工具链,包含编译器(nvcc)、运行时库、数学库(cuBLAS、cuDNN等)。在WSL2场景下有个非常重要的特性:你不需要在Linux侧单独安装NVIDIA驱动,而是复用Windows侧已安装的驱动。这个后面我会详细展开,很多人在这里踩坑。
那为什么是CUDA 11.8而不是更新版本?因为截至我写这篇博文时,PyTorch官方稳定版对CUDA 11.8的支持非常成熟。深度学习场景里,框架和CUDA的版本匹配往往比“最新”更重要。很多自定义算子库、老项目、复现论文代码,都明确写了“CUDA 11.x tested”,你硬上新版CUDA 12.x,很可能在编译层面遇到API变动导致的不兼容。而且Turing、Ampere等较新的架构在CUDA 11.8下已经完美支持,没有版本焦虑的必要。
当然,如果你的项目明确要求CUDA 12.x,那安装流程大同小异,只是下载链接和版本号换一下就行。这篇博文以11.8为主线,但方法本身可以平移到其他版本。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. WSL2环境准备:Ubuntu 22.04的干净安装
2.1 安装前的前置条件检查
动手之前先花两分钟检查系统状态,这能帮你避免大部分“装到一半发现不行”的尴尬。首先是Windows版本要求:WSL2依赖Windows 10版本2004及以上,或者Windows 11。如果你还在老版本上,先去Windows Update把系统更新到位。其次是确保BIOS里开启了虚拟化功能(Intel VT-x或AMD-V),这个不开的话WSL2会直接报错。
另外有一点很多人忽略:如果你机器上装了第三方杀毒软件或系统优化工具,建议安装WSL前暂时退出,部分安全软件会拦截WSL的功能组件注册,导致安装后无法正常启动。我见过好几个案例,症状就是WSL命令行能跑,但一进Ubuntu就黑屏闪退,排查到最后发现是安全软件把虚拟化平台组件给禁用了。
检查完毕,打开PowerShell(管理员模式),执行以下命令确认当前版本信息:
powershell复制# 查看Windows版本
winver
# 查看当前WSL状态
wsl --status
如果wsl命令不存在,说明系统还没装WSL基础组件,直接进入下一步。
2.2 使用wsl --install快速部署WSL2
从Windows 10 2004版本开始,微软提供了极简安装命令,直接在管理员PowerShell里执行:
powershell复制#
