1. 为什么到 2025 年我还在 Windows 上跑 WSL UbuntuWSL、Ubuntu、Windows、Linux 这四个词凑在一起基本就是现在大多数后端、运维、算法、嵌入式从业者的日常桌面形态。我自己的主力机从 2019 年开始就是 Windows 打底、Ubuntu 干活中间换过三台机器、重装过七八次系统踩过的坑足够写一本小册子。这篇就把 2025 年 10 月这个时间点上Windows Subsystem for Linux 搭配 Ubuntu 的完整落地流程捋一遍从装系统一直讲到日常写代码、跑容器、调 GPU尽量做到你看完能直接照着敲。先说清楚它到底解决什么问题。以前我们要在 Windows 上用 Linux无非三条路装双系统、开虚拟机、或者干脆买台机器单独跑。双系统每次切换要重启虚拟机吃内存还掉性能单独一台机器成本高、同步文件还麻烦。WSL 的思路完全不一样它不是模拟一台完整的电脑而是让 Windows 内核直接承担起 Linux 系统调用的翻译工作Ubuntu 的用户态程序原生跑在 Windows 上面。你的bash、grep、apt、ssh都是真的但不用重启、不用分盘、不用等虚拟机开机。这套东西适合谁我大概分三类。第一类是学生和刚入行的朋友手上只有一台 Windows 笔记本想学 Linux 命令、学 Git、学 Docker又不想折腾分区和引导。第二类是从业多年的工程师Windows 上有习惯的办公软件、截图工具、输入法但开发环境必须待在 Linux 里WSL 是唯一能让你两边都不割舍的方案。第三类是做 AI 和数据方向的需要在 Linux 下用 CUDA、跑训练脚本但笔记本是 Windows 本。这三类人加起来基本覆盖了我身边九成的同行。提醒本文操作默认你已经能正常打开 Windows 终端Terminal或者 PowerShell且登录的是有管理员权限的账号。公司电脑如果有统一的安全策略、组策略锁定部分步骤可能被拦这种时候先找 IT 确认别硬来。1.1 WSL、虚拟机、双系统到底怎么选很多人一上来就问我该用哪个其实这个问题没有标准答案得看你每天的使用重心在哪。我把三种方案摊开对比一下你对着自己的情况挑。对比项WSL 2虚拟机如 VMware/VirtualBox双系统启动速度秒级命令一敲就进十几秒到一分钟需要重启几分钟性能损耗接近原生文件 IO 跨系统时略慢CPU 有虚拟化开销内存独占无损耗原生速度文件互访直接访问对方盘符双向需要共享文件夹或网络传输两个系统独立需挂载内存占用动态回收可配置上限开机即占用固定内存只占用当前系统桌面环境默认无 GUI可另装完整图形界面完整图形界面适合场景命令行开发、容器、脚本需要完整桌面或异构系统测试长期只用一个系统我个人的结论很直接除非你要在 Linux 里跑完整的图形桌面、要做驱动级别的实验、或者要做内核调试否则 2025 年没有理由不用 WSL。它的启动体验就像打开一个应用这个差别用久了是回不去的。1.2 WSL 1 和 WSL 2 的架构差异别选错这是最容易踩的坑之一。WSL 1 是翻译式的Windows 内核直接把 Linux 系统调用翻译成 Windows 的对应调用所以文件互访极快但兼容性差Docker 跑不起来很多依赖特定内核特性的程序会报错。WSL 2 换了个思路它内部跑的是一个真正的 Linux 内核由微软维护跑在一个轻量级虚拟化层上兼容性几乎和原生一致Docker、systemd 都能用代价是跨文件系统访问时会慢一些。具体差多少我实测过一个场景在 WSL 里对 5 万个小文件做递归遍历WSL 1 大概 3 秒WSL 2 大概 9 秒但如果把文件放在 Linux 侧的文件系统里操作WSL 2 只要 1.2 秒。结论很清楚——用 WSL 2但代码一定要放在 Linux 自己的文件系统里不要图方便放在/mnt/c/下面写那是性能杀手。提醒默认情况下wsl --install装的就是 WSL 2。如果你机器上还留着老的 WSL 1 发行版可以用wsl --set-version Ubuntu 2单独转换转换过程要几分钟期间别关机。1.3 2025 年这套工具链的几个实际变化这几年 WSL 的迭代速度其实挺快。我自己感受到的明显变化有几个。一是安装方式收敛了早期要手动勾选适用于 Linux 的 Windows 子系统、再开虚拟机平台、再重启、再去商店找发行版现在一条wsl --install基本搞定。二是内核更新走独立通道了不用跟着 Windows 大版本一起升级wsl --update就是一条命令的事。三是 systemd 支持转正了这意味着你可以在 WSL 里用systemctl管理服务跑 Redis、跑 Elasticsearch 这类需要常驻服务的场景友好很多。四是和 VS Code 的集成越来越顺装个扩展就能把整个开发环境接过去。这些变化加起来的直接结果就是现在的安装门槛比三年前低了一大截出错的地方也更容易定位。但反过来说网上大量老教程还停留在旧流程上你照着做反而会绕远路这也是我写这篇的原因。2. 安装前的准备工作与硬件软件门槛动手之前花十分钟做准备能省下后面一小时的排查。我见过太多人卡在虚拟化没开或者C 盘满了这种问题上其实都是可以提前避免的。2.1 系统版本、虚拟化开关与账号权限检查先说版本要求。官方对 WSL 的支持门槛是 Windows 10 版本 2004内部版本 19041及以上或者任意版本的 Windows 11。想用完整的wsl --install一条命令流程最好升到较新的 Windows 11。查版本的方法很简单按Win R输入winver回车就能看到版本号和内部版本号。然后是虚拟化。WSL 2 依赖底层的虚拟化能力如果 BIOS 里没开后面会直接报错。检查方式是打开任务管理器切到性能标签点 CPU看右下角有没有虚拟化已启用。如果显示已禁用就要重启进 BIOS找到Intel VT-x、VT-d或者SVM ModeAMD 平台这类选项打开。不同主板菜单名字不一样一般在 Advanced 或者 CPU Configuration 里面。再确认一下账号权限。装 WSL 需要管理员权限如果你登录的是受限账号wsl --install会直接失败。判断方法是在 PowerShell 里敲一句([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)返回True就是管理员False就右键终端选以管理员身份运行再试。提醒有些笔记本出厂时 BIOS 里默认关掉了虚拟化或者开了之后被厂商的安全软件又拦回去。如果你确认 BIOS 开了但任务管理器还是显示禁用先检查是不是装了第三方安全防护软件在抢占虚拟化层。2.2 磁盘空间规划与目录摆放策略WSL 2 的发行版默认装在系统盘的用户目录下一个干净的 Ubuntu 大概占 1.5 到 3 GB。但你真正用起来之后装 Docker 镜像、跑数据集、编译项目几十 GB 是很正常的事。我建议动手前先给系统盘留出至少 40 GB 空闲长期用的话 100 GB 以上更稳妥。如果你系统盘确实紧张有两种办法。一是先把 WSL 装好然后用导出导入的方式迁到其他盘命令是wsl --export和wsl --import这个我在第 3 章会详细说。二是提前把 Windows 的应用安装位置设置改成其他盘不过这个设置对 WSL 是否生效在不同版本上表现不一致实测不如导出导入可靠。还有一个容易被忽略的点WSL 的虚拟磁盘文件是一个叫ext4.vhdx的动态扩展文件它只会变大不会自动变小。你删掉里面的大文件Windows 这边的磁盘占用不会立刻释放。所以在规划空间时要按峰值用量来留而不是按当前用量。2.3 终端与字体先把敲命令的体验铺垫好这一步不是必需的但强烈推荐。默认的旧版控制台字体难看、中文容易错位、字符宽度对不齐用久了眼睛累。我的做法是装 Windows Terminal如果系统里还没有的话然后在设置里把默认配置文件设成 Ubuntu字体换成等宽字体。关于字体很多人想要接近 macOS 那种观感核心其实就三点字形宽度均匀、中英文对齐、行高舒服。市面上常用的等宽字体有 Cascadia Code、JetBrains Mono、Fira Code、Maple Mono 等。Cascadia Code 是微软自家出的和 Windows Terminal 配合最省心JetBrains Mono 的字形更圆润一些接近 macOS 上的感觉。如果中英文混排要求高可以找带中文的等宽字体或者设置字体回退链。在 Windows Terminal 的settings.json里可以这样写{ profiles: { defaults: { font: { face: JetBrains Mono, size: 12, lineHeight: 1.2 }, colorScheme: One Half Dark } } }行高调到 1.2 左右是我试出来最舒服的值默认的 1.0 会显得挤。这个设置改完之后后面所有的命令行操作体感都会好一截。3. 三条安装路线实测从一键脚本到离线兜底安装本身其实不复杂但不同网络环境、不同系统版本的差异很大所以我准备了三套方案。按顺序试第一套不行就退到第二套第二套不行再上第三套。3.1 路线一wsl --install 一条命令走通这是 2025 年最推荐的方式也是最省事的。以管理员身份打开 PowerShell 或者 Windows Terminal敲wsl --install回车之后它会自动做这么几件事启用适用于 Linux 的 Windows 子系统和虚拟机平台两个可选组件、下载并安装 WSL 2 内核、把 WSL 的默认版本设为 2、下载 Ubuntu 发行版并完成初始化。整个过程大概需要几分钟中途可能会弹一次重启提示重启后会自动继续进入 Ubuntu 的初始化界面让你设置用户名和密码。如果你想指定发行版可以先看看有哪些可选wsl --list --online输出里会列出 Ubuntu、Debian、Kali Linux 等一堆名字。装指定的那个就加参数wsl --install -d Ubuntu-24.04这里有个细节要注意-d后面跟的是发行版名称必须和列表里的名字完全一致大小写和连字符都不能错。注意Ubuntu 的用户名不要用中文也不要用大写字母开头。密码输入时屏幕上不会显示任何字符这是正常的别以为键盘坏了。这个密码就是你的sudo密码忘了的话后面要用 root 重置比较麻烦。3.2 路线二手动启用组件 商店安装如果wsl --install因为组策略、网络或者版本原因失败可以拆开手动做。先启用两个 Windows 功能dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart两条命令都返回成功之后重启电脑。重启完下载 WSL 2 内核更新包手动安装然后在 PowerShell 里设置默认版本wsl --set-default-version 2最后打开 Microsoft Store 搜索 Ubuntu找到官方发布的那一个点安装装完第一次启动同样会走一遍用户名密码初始化。这条路线的好处是每一步都能看到结果出问题容易定位是哪一环卡住了。3.3 路线三离线包与导入导出兜底方案有些环境完全连不上外网或者公司网络对商店做了限制这时候就得走离线路线。思路是在一台能联网的机器上把发行版导出成 tar 包拷到目标机器再导入。导出命令在源机器上执行wsl --export Ubuntu D:\backup\ubuntu-backup.tar这个 tar 包就是整个根文件系统的快照。拷到目标机器之后先建一个目录用来放虚拟磁盘然后导入mkdir D:\wsl\ubuntu wsl --import Ubuntu D:\wsl\ubuntu D:\backup\ubuntu-backup.tar --version 2导入完成后用wsl -d Ubuntu进去。这里有个常见的坑通过 import 方式装进来的发行版默认登录用户是 root不会走初始化流程也不会问你要用户名密码。想改回普通用户需要改注册表里的默认用户或者干脆在/etc/wsl.conf里写死[user] defaultyourname写完保存回到 PowerShell 执行wsl --shutdown再重进用户就切过来了。3.4 三条路线的对比与选择建议路线适用场景耗时主要风险wsl --install一键个人机、网络通畅5-10 分钟下载慢、商店被拦手动启用组件一键失败、组策略限制15-20 分钟步骤多、容易漏重启离线导出导入内网机器、完全无外网取决于文件大小默认用户是 root、路径要写对我自己的习惯是先用一键失败两次以上就立刻切离线不要在一键上反复耗时间。因为一键失败通常是网络原因重试十次还是同样的结果。4. Ubuntu 首次进系统后的必经配置装完只是开始一个没配置过的 Ubuntu 用起来到处是别扭。这一章讲的是我每次装完新环境都会做的几件事顺序基本固定。4.1 系统更新、apt 换源与常用工具补齐第一件事永远是更新sudo apt update sudo apt upgrade -y但默认的软件源在国外国内访问经常慢到怀疑人生几 KB 每秒是常态。所以更新之前先换源更划算。做法是备份原文件再替换sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak sudo sed -i s|archive.ubuntu.com|mirrors.example.edu.cn|g /etc/apt/sources.list新版本的 Ubuntu 用的是sources.list.d/ubuntu.sources这种 deb822 格式改法和上面类似把 URI 字段指向国内镜像站即可。换完之后apt update一般是几秒钟的事。常用工具我一般一次性装齐sudo apt install -y build-essential git curl wget vim htop tree unzip zip net-tools这里面build-essential是编译工具链git和curl是基础设施htop看系统状态比top舒服tree看目录结构直观。装完之后git要配一下身份git config --global user.name your_name git config --global user.email youremail.com提醒换源之后如果apt update报签名错误多半是源地址写错或者镜像站没同步完整。切回官方源验证一下确认是源的问题再换另一个镜像站。4.2 中文输入法与中文显示的处理WSL 默认是纯命令行环境本身不需要输入法。但如果你打算在里面装 GUI 应用、看中文文档、或者用 VS Code 的终端跑输出中文的脚本中文显示就会出问题——表现为方块、乱码、或者宽度对不齐。处理思路分两层。第一层是 locale 设置检查当前值locale如果输出里LANG是C或者POSIX中文会显示异常。改成 UTF-8sudo apt install -y locales sudo locale-gen en_US.UTF-8 sudo update-locale LANGen_US.UTF-8第二层是字体。命令行里要想正常显示中文需要一个带中文字形的等宽字体。可以装fonts-noto-cjksudo apt install -y fonts-noto-cjk如果你在 Windows Terminal 里用字体其实由 Windows 侧决定Ubuntu 里装不装影响不大但如果你走的是 X Server 转发或者第三方终端那就得装。至于图形界面的中文输入法那是另一个话题——WSL 默认没有原生 GUI装输入法之前得先把显示方案解决掉复杂度明显高于命令行场景我不建议新手一上来就折腾这个。4.3 文件系统互通与路径映射的细节这是 WSL 最有价值的能力之一也是最容易踩坑的地方。Windows 的盘符在 WSL 里挂载在/mnt/下面C 盘就是/mnt/c。反过来Ubuntu 的文件在 Windows 里可以通过\\wsl$\Ubuntu\这个网络路径访问在资源管理器地址栏敲这个就能打开。但有两个坑必须说。第一个是前面提过的性能问题代码项目一定要放在 Linux 侧的家目录里比如/home/yourname/projects不要放在/mnt/c/Users/...下面。原因是 WSL 2 访问 Windows 文件系统要经过一层 9P 协议转换小文件多的场景能慢十倍以上。我见过有人把node_modules放在 Windows 侧npm install跑了二十分钟。第二个是权限和换行符。Windows 侧的文件默认权限是 777而且行尾是 CRLF直接拿去 Linux 里跑脚本会报bad interpreter这种诡异错误。解决办法一个是把项目放 Linux 侧另一个是在项目里加.gitattributes统一换行符* textauto eollf或者配置 Git 全局处理git config --global core.autocrlf input提醒不要在 WSL 里用chmod去改/mnt/c下面的文件权限改了也不会生效还会让你困惑半天。这是设计如此不是 bug。4.4 内存、CPU 与磁盘的动态调节WSL 2 默认会拿走最多一半的物理内存和全部逻辑核心。对台式机来说没问题但笔记本上会导致 Windows 侧变卡。解决办法是在 Windows 用户目录下建一个.wslconfig文件[wsl2] memory8GB processors6 swap4GB localhostForwardingtrue放的位置是C:\Users\你的用户名\.wslconfig建完执行wsl --shutdown让它生效。内存给多少合适我的经验是留出 4 GB 给 Windows 常驻剩下的按七三分配比如 32 GB 内存给 WSL 8 到 12 GB 比较舒服。还有一个隐藏问题磁盘文件只涨不缩。跑久了ext4.vhdx可能膨胀到几十 GB即使里面实际只用了几 GB。清理方式是先用wsl --shutdown关掉然后用磁盘管理工具压缩或者直接在 PowerShell 里操作wsl --shutdown Optimize-VHD -Path D:\wsl\ubuntu\ext4.vhdx -Mode Full注意Optimize-VHD需要 Hyper-V 模块家庭版可能没有那就用第三方分区工具处理。5. 把开发环境真正跑起来VS Code、Docker 与 GPU基础环境配好之后接下来是让它真正能干活。这一章是我日常使用频率最高的部分。5.1 在 VS Code 里无缝使用 WSL这是我最推荐的一个组合。装完 VS Code 和官方 WSL 扩展之后你在 Ubuntu 终端里进入项目目录敲一句code .VS Code 就会以 WSL 模式打开这个目录。此时所有插件、终端、调试器都跑在 Linux 侧文件路径也是 Linux 路径但界面依然是 Windows 的原生窗口。这个体验比在 Windows 侧打开项目再连远程要顺畅得多。装扩展的时候要注意区分插件商店里有些扩展标了Remote标签这些装在 WSL 侧没标的装在 Windows 侧。你打开扩展面板时装到哪一边取决于你当前窗口的模式装错了会出现命令找不到的情况。我一般的原则是语言相关的Python、Go、C 插件装 WSL 侧界面相关的主题、图标装 Windows 侧。5.2 Docker 在 WSL 里的两种装法Docker 有两种路子。第一种是装 Docker Desktop for Windows然后在设置里勾选使用 WSL 2 引擎它会自动把 Docker 上下文注入到你的 Ubuntu 里你在 WSL 里敲docker ps就能用。这种方式省心但 Docker Desktop 有商业授权限制公司规模大的话要注意合规。第二种是在 Ubuntu 里直接装 Docker Engine完全绕开 Windows 侧sudo apt install -y ca-certificates curl gnupg curl -fsSL https://get.docker.com | sudo sh sudo usermod -aG docker $USER装完要重新登录一次让用户组生效。这种方式的好处是干净、没有额外授权问题坏处是没有图形界面管理。我个人在个人机器上用第二种公司环境看合规要求选第一种。验证是否正常docker run --rm hello-world看到输出里出现欢迎信息就说明通了。注意usermod -aG docker这一句如果不加-a会把你的用户从其他所有附加组里踢出去可能导致 sudo 都用不了。这个参数千万不能漏。5.3 CUDA 与 GPU 直通的关键前提搞 AI 的人最关心这个。好消息是 WSL 2 支持 GPU 直通坏消息是有几个硬性前提。第一必须是 WSL 2WSL 1 完全不支持。第二Windows 侧要装对应显卡厂商的最新驱动注意是 Windows 驱动不是 Linux 驱动——WSL 里的 CUDA 是复用 Windows 驱动通过虚拟化层转发的。第三Ubuntu 里要装 CUDA Toolkit但不要装 Linux 版显卡驱动装了会冲突。验证步骤是先装工具包sudo apt install -y nvidia-cuda-toolkit然后运行nvidia-smi如果能看到显卡型号、显存、驱动版本说明通路已经打通。如果报command not found或者No devices were found回头检查 Windows 侧的驱动版本是否够新。这里我踩过一次坑显卡驱动装太旧nvidia-smi能跑但 CUDA 程序报版本不匹配。后来把 Windows 驱动升到最新问题立刻消失。所以我建议装完 WSL 之后顺手把显卡驱动更新到最新这一步能省掉后面大量排查时间。5.4 让终端接近 macOS 观感的字体与主题配置最后聊聊颜值虽然是次要的但每天面对十几个小时的界面舒服一点确实影响心情。接近 macOS 观感的关键其实不在主题配色而在字体的字形设计和间距。我的配置是这样的字体用 JetBrains Mono 或者 Maple Mono字号 12 到 13行高 1.2开启字体连字ligatures。配色用低饱和度的深色方案避免纯黑背景配纯白文字那种对比度太高看久了眼睛疼。Ubuntu 侧的PS1提示符可以简化一下把冗长的路径显示改成只显示当前目录名配置写在~/.bashrc里export PS1\[\e[32m\]\u\h\[\e[0m\]:\[\e[34m\]\w\[\e[0m\]\$ 想要更现代的体验可以上 zsh 加 oh-my-zsh但说实话如果你只是日常敲命令bash 加上合理的提示符配置已经够用装一大堆插件反而拖慢每次开终端的速度。6. 常见故障速查与排查实录前面讲的是顺路情况这一章讲的是翻车现场。我把这些年遇到频率最高的问题整理成表附上我的实际处理方式。6.1 安装卡慢、下载中断与网络相关故障wsl --install卡在下载阶段是最常见的问题表现是进度条长时间不动或者报超时错误。原因通常是发行版包体较大而下载源在国外。处理方式有几个换时间段重试凌晨确实快一些、用wsl --update单独更新内核内核包小很多、或者干脆走第 3 章说的离线导入。还有一个情况是安装完成了但wsl命令本身很慢才响应敲个命令要等两三秒。这通常和系统资源占用有关检查一下是不是有安全软件在实时扫描 WSL 的虚拟磁盘文件。把 WSL 相关目录加入排除列表之后会明显改善。现象可能原因处理方式下载进度长时间不动源站访问慢换时段重试或走离线导入报WslRegisterDistribution failed虚拟化未开或版本不符检查 BIOS 虚拟化开关、系统版本命令响应慢杀毒软件扫描虚拟磁盘把 WSL 目录加入排除列表装完找不到发行版商店缓存问题wsl --list --all检查后重新安装6.2 SSH 连接不上与端口转发排查WSL 里的 SSH 服务有个特点它监听的端口在 Windows 侧是可以通过localhost直接访问的微软做了自动转发。但很多人反馈连不上原因一般有三个。第一Ubuntu 里根本没装或没启动 SSH 服务sudo apt install -y openssh-server sudo service ssh start第二配置文件里PermitRootLogin或者PasswordAuthentication被禁掉了查/etc/ssh/sshd_config。第三端口冲突Windows 侧已经有个程序占了 22 端口这时候要改 WSL 里 SSH 的监听端口。还有一种情况是你在 WSL 里跑了某个 Web 服务浏览器访问localhost打不开。这时候先确认服务监听的是0.0.0.0而不是127.0.0.1后者在 WSL 2 的虚拟化网络下可能转发不到。改监听地址一般就能解决。6.3 中文乱码、解压乱码与编码相关问题压缩包解压出来文件名全是乱码这是从 Windows 打包、在 Linux 解压时的经典问题。根源是 Windows 上打包工具用了 GBK 编码写文件名而 Linux 按 UTF-8 去读。处理方式是解压时指定编码或者用能识别编码的工具。比如处理 zipunzip -O gbk archive.zip -d output/如果-O参数不支持不同发行版的 unzip 版本有差异可以先在 Windows 侧用支持 UTF-8 的打包工具重新压一次这是更省事的做法。终端里显示乱码则回到 4.2 节讲的 locale 和字体问题。两者容易混淆判断方法是用cat看文件内容乱码是编码问题用ls看文件名乱码是文件名编码问题。6.4 我踩过的几个非典型坑说几个不那么常见但很折腾人的。第一个是时间不同步。笔记本休眠唤醒之后WSL 里的时间可能和 Windows 差几个小时导致 Git 提交时间错乱、HTTPS 证书校验失败。解决办法是同步一下sudo hwclock -s第二个是wsl --shutdown之后网络断掉重进恢复正常这通常是 Windows 侧的网络驱动或者安全软件在切换网络时干扰了虚拟网卡重启一次 Windows 比反复重启 WSL 有效。第三个是文件句柄泄漏。长时间跑 Docker 容器之后你会发现 WSL 占的内存越来越多free -h显示缓存区巨大。这是 Linux 的正常行为缓存会按需回收不用手动清。但如果真到了影响 Windows 的地步wsl --shutdown是最彻底的解法代价是所有服务要重启。第四个是关于在 WSL 里跑 Elasticsearch、Redis 这类带内存要求的服务。WSL 的默认内存上限可能会让它们启动失败报max virtual memory areas vm.max_map_count is too low之类。处理方式是在/etc/sysctl.conf里加大限制或者直接在.wslconfig里给 WSL 更多内存。sudo sysctl -w vm.max_map_count262144这行只能临时生效写进配置文件才能持久化。提醒每次修改.wslconfig或者/etc/wsl.conf都必须执行wsl --shutdown再重新进入配置才会重新加载。直接在运行的实例里改看不到任何效果。6.5 什么时候该推倒重来最后分享一个判断经验什么时候该修什么时候该重装。我的标准是如果问题涉及系统级的组件损坏比如 apt 彻底坏掉、系统库被误删、locale 配置混乱到无法生成重装一个干净发行版的成本远低于修复。因为 WSL 的发行版本质就是一个 tar 包加一个虚拟磁盘删掉再导入只要几分钟。备份方式也很简单wsl --export定期导一次 tar 包放在别的盘上。我一般两周导一次体积几十 GB 但心里踏实。真出问题的时候wsl --unregister干掉旧的再wsl --import导回来十分钟之内环境就恢复到导出时的状态比现场排查省事得多。故障等级典型表现建议处理轻微某个命令报错、配置项写错直接改配置中等apt 依赖冲突、服务起不来尝试修复设时间上限严重系统库损坏、无法进入 shell导出数据后重装发行版灾难虚拟磁盘损坏从最近一次备份导入这套 WSL 加 Ubuntu 的组合我从最初的手忙脚乱到现在半小时能搭好一套完整开发环境中间交了不少学费。最想说的是两点一是把项目文件放在 Linux 侧的文件系统里这一个习惯能解决一半以上的性能抱怨二是提前配好.wslconfig和备份习惯前者让你平时用得舒服后者让你出事的时候不慌。剩下的就是多用命令敲熟了自然就有感觉了。
WSL 2 + Ubuntu 开发环境：安装、Docker/GPU 与调优
1. 为什么到 2025 年我还在 Windows 上跑 WSL UbuntuWSL、Ubuntu、Windows、Linux 这四个词凑在一起基本就是现在大多数后端、运维、算法、嵌入式从业者的日常桌面形态。我自己的主力机从 2019 年开始就是 Windows 打底、Ubuntu 干活中间换过三台机器、重装过七八次系统踩过的坑足够写一本小册子。这篇就把 2025 年 10 月这个时间点上Windows Subsystem for Linux 搭配 Ubuntu 的完整落地流程捋一遍从装系统一直讲到日常写代码、跑容器、调 GPU尽量做到你看完能直接照着敲。先说清楚它到底解决什么问题。以前我们要在 Windows 上用 Linux无非三条路装双系统、开虚拟机、或者干脆买台机器单独跑。双系统每次切换要重启虚拟机吃内存还掉性能单独一台机器成本高、同步文件还麻烦。WSL 的思路完全不一样它不是模拟一台完整的电脑而是让 Windows 内核直接承担起 Linux 系统调用的翻译工作Ubuntu 的用户态程序原生跑在 Windows 上面。你的bash、grep、apt、ssh都是真的但不用重启、不用分盘、不用等虚拟机开机。这套东西适合谁我大概分三类。第一类是学生和刚入行的朋友手上只有一台 Windows 笔记本想学 Linux 命令、学 Git、学 Docker又不想折腾分区和引导。第二类是从业多年的工程师Windows 上有习惯的办公软件、截图工具、输入法但开发环境必须待在 Linux 里WSL 是唯一能让你两边都不割舍的方案。第三类是做 AI 和数据方向的需要在 Linux 下用 CUDA、跑训练脚本但笔记本是 Windows 本。这三类人加起来基本覆盖了我身边九成的同行。提醒本文操作默认你已经能正常打开 Windows 终端Terminal或者 PowerShell且登录的是有管理员权限的账号。公司电脑如果有统一的安全策略、组策略锁定部分步骤可能被拦这种时候先找 IT 确认别硬来。1.1 WSL、虚拟机、双系统到底怎么选很多人一上来就问我该用哪个其实这个问题没有标准答案得看你每天的使用重心在哪。我把三种方案摊开对比一下你对着自己的情况挑。对比项WSL 2虚拟机如 VMware/VirtualBox双系统启动速度秒级命令一敲就进十几秒到一分钟需要重启几分钟性能损耗接近原生文件 IO 跨系统时略慢CPU 有虚拟化开销内存独占无损耗原生速度文件互访直接访问对方盘符双向需要共享文件夹或网络传输两个系统独立需挂载内存占用动态回收可配置上限开机即占用固定内存只占用当前系统桌面环境默认无 GUI可另装完整图形界面完整图形界面适合场景命令行开发、容器、脚本需要完整桌面或异构系统测试长期只用一个系统我个人的结论很直接除非你要在 Linux 里跑完整的图形桌面、要做驱动级别的实验、或者要做内核调试否则 2025 年没有理由不用 WSL。它的启动体验就像打开一个应用这个差别用久了是回不去的。1.2 WSL 1 和 WSL 2 的架构差异别选错这是最容易踩的坑之一。WSL 1 是翻译式的Windows 内核直接把 Linux 系统调用翻译成 Windows 的对应调用所以文件互访极快但兼容性差Docker 跑不起来很多依赖特定内核特性的程序会报错。WSL 2 换了个思路它内部跑的是一个真正的 Linux 内核由微软维护跑在一个轻量级虚拟化层上兼容性几乎和原生一致Docker、systemd 都能用代价是跨文件系统访问时会慢一些。具体差多少我实测过一个场景在 WSL 里对 5 万个小文件做递归遍历WSL 1 大概 3 秒WSL 2 大概 9 秒但如果把文件放在 Linux 侧的文件系统里操作WSL 2 只要 1.2 秒。结论很清楚——用 WSL 2但代码一定要放在 Linux 自己的文件系统里不要图方便放在/mnt/c/下面写那是性能杀手。提醒默认情况下wsl --install装的就是 WSL 2。如果你机器上还留着老的 WSL 1 发行版可以用wsl --set-version Ubuntu 2单独转换转换过程要几分钟期间别关机。1.3 2025 年这套工具链的几个实际变化这几年 WSL 的迭代速度其实挺快。我自己感受到的明显变化有几个。一是安装方式收敛了早期要手动勾选适用于 Linux 的 Windows 子系统、再开虚拟机平台、再重启、再去商店找发行版现在一条wsl --install基本搞定。二是内核更新走独立通道了不用跟着 Windows 大版本一起升级wsl --update就是一条命令的事。三是 systemd 支持转正了这意味着你可以在 WSL 里用systemctl管理服务跑 Redis、跑 Elasticsearch 这类需要常驻服务的场景友好很多。四是和 VS Code 的集成越来越顺装个扩展就能把整个开发环境接过去。这些变化加起来的直接结果就是现在的安装门槛比三年前低了一大截出错的地方也更容易定位。但反过来说网上大量老教程还停留在旧流程上你照着做反而会绕远路这也是我写这篇的原因。2. 安装前的准备工作与硬件软件门槛动手之前花十分钟做准备能省下后面一小时的排查。我见过太多人卡在虚拟化没开或者C 盘满了这种问题上其实都是可以提前避免的。2.1 系统版本、虚拟化开关与账号权限检查先说版本要求。官方对 WSL 的支持门槛是 Windows 10 版本 2004内部版本 19041及以上或者任意版本的 Windows 11。想用完整的wsl --install一条命令流程最好升到较新的 Windows 11。查版本的方法很简单按Win R输入winver回车就能看到版本号和内部版本号。然后是虚拟化。WSL 2 依赖底层的虚拟化能力如果 BIOS 里没开后面会直接报错。检查方式是打开任务管理器切到性能标签点 CPU看右下角有没有虚拟化已启用。如果显示已禁用就要重启进 BIOS找到Intel VT-x、VT-d或者SVM ModeAMD 平台这类选项打开。不同主板菜单名字不一样一般在 Advanced 或者 CPU Configuration 里面。再确认一下账号权限。装 WSL 需要管理员权限如果你登录的是受限账号wsl --install会直接失败。判断方法是在 PowerShell 里敲一句([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)返回True就是管理员False就右键终端选以管理员身份运行再试。提醒有些笔记本出厂时 BIOS 里默认关掉了虚拟化或者开了之后被厂商的安全软件又拦回去。如果你确认 BIOS 开了但任务管理器还是显示禁用先检查是不是装了第三方安全防护软件在抢占虚拟化层。2.2 磁盘空间规划与目录摆放策略WSL 2 的发行版默认装在系统盘的用户目录下一个干净的 Ubuntu 大概占 1.5 到 3 GB。但你真正用起来之后装 Docker 镜像、跑数据集、编译项目几十 GB 是很正常的事。我建议动手前先给系统盘留出至少 40 GB 空闲长期用的话 100 GB 以上更稳妥。如果你系统盘确实紧张有两种办法。一是先把 WSL 装好然后用导出导入的方式迁到其他盘命令是wsl --export和wsl --import这个我在第 3 章会详细说。二是提前把 Windows 的应用安装位置设置改成其他盘不过这个设置对 WSL 是否生效在不同版本上表现不一致实测不如导出导入可靠。还有一个容易被忽略的点WSL 的虚拟磁盘文件是一个叫ext4.vhdx的动态扩展文件它只会变大不会自动变小。你删掉里面的大文件Windows 这边的磁盘占用不会立刻释放。所以在规划空间时要按峰值用量来留而不是按当前用量。2.3 终端与字体先把敲命令的体验铺垫好这一步不是必需的但强烈推荐。默认的旧版控制台字体难看、中文容易错位、字符宽度对不齐用久了眼睛累。我的做法是装 Windows Terminal如果系统里还没有的话然后在设置里把默认配置文件设成 Ubuntu字体换成等宽字体。关于字体很多人想要接近 macOS 那种观感核心其实就三点字形宽度均匀、中英文对齐、行高舒服。市面上常用的等宽字体有 Cascadia Code、JetBrains Mono、Fira Code、Maple Mono 等。Cascadia Code 是微软自家出的和 Windows Terminal 配合最省心JetBrains Mono 的字形更圆润一些接近 macOS 上的感觉。如果中英文混排要求高可以找带中文的等宽字体或者设置字体回退链。在 Windows Terminal 的settings.json里可以这样写{ profiles: { defaults: { font: { face: JetBrains Mono, size: 12, lineHeight: 1.2 }, colorScheme: One Half Dark } } }行高调到 1.2 左右是我试出来最舒服的值默认的 1.0 会显得挤。这个设置改完之后后面所有的命令行操作体感都会好一截。3. 三条安装路线实测从一键脚本到离线兜底安装本身其实不复杂但不同网络环境、不同系统版本的差异很大所以我准备了三套方案。按顺序试第一套不行就退到第二套第二套不行再上第三套。3.1 路线一wsl --install 一条命令走通这是 2025 年最推荐的方式也是最省事的。以管理员身份打开 PowerShell 或者 Windows Terminal敲wsl --install回车之后它会自动做这么几件事启用适用于 Linux 的 Windows 子系统和虚拟机平台两个可选组件、下载并安装 WSL 2 内核、把 WSL 的默认版本设为 2、下载 Ubuntu 发行版并完成初始化。整个过程大概需要几分钟中途可能会弹一次重启提示重启后会自动继续进入 Ubuntu 的初始化界面让你设置用户名和密码。如果你想指定发行版可以先看看有哪些可选wsl --list --online输出里会列出 Ubuntu、Debian、Kali Linux 等一堆名字。装指定的那个就加参数wsl --install -d Ubuntu-24.04这里有个细节要注意-d后面跟的是发行版名称必须和列表里的名字完全一致大小写和连字符都不能错。注意Ubuntu 的用户名不要用中文也不要用大写字母开头。密码输入时屏幕上不会显示任何字符这是正常的别以为键盘坏了。这个密码就是你的sudo密码忘了的话后面要用 root 重置比较麻烦。3.2 路线二手动启用组件 商店安装如果wsl --install因为组策略、网络或者版本原因失败可以拆开手动做。先启用两个 Windows 功能dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart两条命令都返回成功之后重启电脑。重启完下载 WSL 2 内核更新包手动安装然后在 PowerShell 里设置默认版本wsl --set-default-version 2最后打开 Microsoft Store 搜索 Ubuntu找到官方发布的那一个点安装装完第一次启动同样会走一遍用户名密码初始化。这条路线的好处是每一步都能看到结果出问题容易定位是哪一环卡住了。3.3 路线三离线包与导入导出兜底方案有些环境完全连不上外网或者公司网络对商店做了限制这时候就得走离线路线。思路是在一台能联网的机器上把发行版导出成 tar 包拷到目标机器再导入。导出命令在源机器上执行wsl --export Ubuntu D:\backup\ubuntu-backup.tar这个 tar 包就是整个根文件系统的快照。拷到目标机器之后先建一个目录用来放虚拟磁盘然后导入mkdir D:\wsl\ubuntu wsl --import Ubuntu D:\wsl\ubuntu D:\backup\ubuntu-backup.tar --version 2导入完成后用wsl -d Ubuntu进去。这里有个常见的坑通过 import 方式装进来的发行版默认登录用户是 root不会走初始化流程也不会问你要用户名密码。想改回普通用户需要改注册表里的默认用户或者干脆在/etc/wsl.conf里写死[user] defaultyourname写完保存回到 PowerShell 执行wsl --shutdown再重进用户就切过来了。3.4 三条路线的对比与选择建议路线适用场景耗时主要风险wsl --install一键个人机、网络通畅5-10 分钟下载慢、商店被拦手动启用组件一键失败、组策略限制15-20 分钟步骤多、容易漏重启离线导出导入内网机器、完全无外网取决于文件大小默认用户是 root、路径要写对我自己的习惯是先用一键失败两次以上就立刻切离线不要在一键上反复耗时间。因为一键失败通常是网络原因重试十次还是同样的结果。4. Ubuntu 首次进系统后的必经配置装完只是开始一个没配置过的 Ubuntu 用起来到处是别扭。这一章讲的是我每次装完新环境都会做的几件事顺序基本固定。4.1 系统更新、apt 换源与常用工具补齐第一件事永远是更新sudo apt update sudo apt upgrade -y但默认的软件源在国外国内访问经常慢到怀疑人生几 KB 每秒是常态。所以更新之前先换源更划算。做法是备份原文件再替换sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak sudo sed -i s|archive.ubuntu.com|mirrors.example.edu.cn|g /etc/apt/sources.list新版本的 Ubuntu 用的是sources.list.d/ubuntu.sources这种 deb822 格式改法和上面类似把 URI 字段指向国内镜像站即可。换完之后apt update一般是几秒钟的事。常用工具我一般一次性装齐sudo apt install -y build-essential git curl wget vim htop tree unzip zip net-tools这里面build-essential是编译工具链git和curl是基础设施htop看系统状态比top舒服tree看目录结构直观。装完之后git要配一下身份git config --global user.name your_name git config --global user.email youremail.com提醒换源之后如果apt update报签名错误多半是源地址写错或者镜像站没同步完整。切回官方源验证一下确认是源的问题再换另一个镜像站。4.2 中文输入法与中文显示的处理WSL 默认是纯命令行环境本身不需要输入法。但如果你打算在里面装 GUI 应用、看中文文档、或者用 VS Code 的终端跑输出中文的脚本中文显示就会出问题——表现为方块、乱码、或者宽度对不齐。处理思路分两层。第一层是 locale 设置检查当前值locale如果输出里LANG是C或者POSIX中文会显示异常。改成 UTF-8sudo apt install -y locales sudo locale-gen en_US.UTF-8 sudo update-locale LANGen_US.UTF-8第二层是字体。命令行里要想正常显示中文需要一个带中文字形的等宽字体。可以装fonts-noto-cjksudo apt install -y fonts-noto-cjk如果你在 Windows Terminal 里用字体其实由 Windows 侧决定Ubuntu 里装不装影响不大但如果你走的是 X Server 转发或者第三方终端那就得装。至于图形界面的中文输入法那是另一个话题——WSL 默认没有原生 GUI装输入法之前得先把显示方案解决掉复杂度明显高于命令行场景我不建议新手一上来就折腾这个。4.3 文件系统互通与路径映射的细节这是 WSL 最有价值的能力之一也是最容易踩坑的地方。Windows 的盘符在 WSL 里挂载在/mnt/下面C 盘就是/mnt/c。反过来Ubuntu 的文件在 Windows 里可以通过\\wsl$\Ubuntu\这个网络路径访问在资源管理器地址栏敲这个就能打开。但有两个坑必须说。第一个是前面提过的性能问题代码项目一定要放在 Linux 侧的家目录里比如/home/yourname/projects不要放在/mnt/c/Users/...下面。原因是 WSL 2 访问 Windows 文件系统要经过一层 9P 协议转换小文件多的场景能慢十倍以上。我见过有人把node_modules放在 Windows 侧npm install跑了二十分钟。第二个是权限和换行符。Windows 侧的文件默认权限是 777而且行尾是 CRLF直接拿去 Linux 里跑脚本会报bad interpreter这种诡异错误。解决办法一个是把项目放 Linux 侧另一个是在项目里加.gitattributes统一换行符* textauto eollf或者配置 Git 全局处理git config --global core.autocrlf input提醒不要在 WSL 里用chmod去改/mnt/c下面的文件权限改了也不会生效还会让你困惑半天。这是设计如此不是 bug。4.4 内存、CPU 与磁盘的动态调节WSL 2 默认会拿走最多一半的物理内存和全部逻辑核心。对台式机来说没问题但笔记本上会导致 Windows 侧变卡。解决办法是在 Windows 用户目录下建一个.wslconfig文件[wsl2] memory8GB processors6 swap4GB localhostForwardingtrue放的位置是C:\Users\你的用户名\.wslconfig建完执行wsl --shutdown让它生效。内存给多少合适我的经验是留出 4 GB 给 Windows 常驻剩下的按七三分配比如 32 GB 内存给 WSL 8 到 12 GB 比较舒服。还有一个隐藏问题磁盘文件只涨不缩。跑久了ext4.vhdx可能膨胀到几十 GB即使里面实际只用了几 GB。清理方式是先用wsl --shutdown关掉然后用磁盘管理工具压缩或者直接在 PowerShell 里操作wsl --shutdown Optimize-VHD -Path D:\wsl\ubuntu\ext4.vhdx -Mode Full注意Optimize-VHD需要 Hyper-V 模块家庭版可能没有那就用第三方分区工具处理。5. 把开发环境真正跑起来VS Code、Docker 与 GPU基础环境配好之后接下来是让它真正能干活。这一章是我日常使用频率最高的部分。5.1 在 VS Code 里无缝使用 WSL这是我最推荐的一个组合。装完 VS Code 和官方 WSL 扩展之后你在 Ubuntu 终端里进入项目目录敲一句code .VS Code 就会以 WSL 模式打开这个目录。此时所有插件、终端、调试器都跑在 Linux 侧文件路径也是 Linux 路径但界面依然是 Windows 的原生窗口。这个体验比在 Windows 侧打开项目再连远程要顺畅得多。装扩展的时候要注意区分插件商店里有些扩展标了Remote标签这些装在 WSL 侧没标的装在 Windows 侧。你打开扩展面板时装到哪一边取决于你当前窗口的模式装错了会出现命令找不到的情况。我一般的原则是语言相关的Python、Go、C 插件装 WSL 侧界面相关的主题、图标装 Windows 侧。5.2 Docker 在 WSL 里的两种装法Docker 有两种路子。第一种是装 Docker Desktop for Windows然后在设置里勾选使用 WSL 2 引擎它会自动把 Docker 上下文注入到你的 Ubuntu 里你在 WSL 里敲docker ps就能用。这种方式省心但 Docker Desktop 有商业授权限制公司规模大的话要注意合规。第二种是在 Ubuntu 里直接装 Docker Engine完全绕开 Windows 侧sudo apt install -y ca-certificates curl gnupg curl -fsSL https://get.docker.com | sudo sh sudo usermod -aG docker $USER装完要重新登录一次让用户组生效。这种方式的好处是干净、没有额外授权问题坏处是没有图形界面管理。我个人在个人机器上用第二种公司环境看合规要求选第一种。验证是否正常docker run --rm hello-world看到输出里出现欢迎信息就说明通了。注意usermod -aG docker这一句如果不加-a会把你的用户从其他所有附加组里踢出去可能导致 sudo 都用不了。这个参数千万不能漏。5.3 CUDA 与 GPU 直通的关键前提搞 AI 的人最关心这个。好消息是 WSL 2 支持 GPU 直通坏消息是有几个硬性前提。第一必须是 WSL 2WSL 1 完全不支持。第二Windows 侧要装对应显卡厂商的最新驱动注意是 Windows 驱动不是 Linux 驱动——WSL 里的 CUDA 是复用 Windows 驱动通过虚拟化层转发的。第三Ubuntu 里要装 CUDA Toolkit但不要装 Linux 版显卡驱动装了会冲突。验证步骤是先装工具包sudo apt install -y nvidia-cuda-toolkit然后运行nvidia-smi如果能看到显卡型号、显存、驱动版本说明通路已经打通。如果报command not found或者No devices were found回头检查 Windows 侧的驱动版本是否够新。这里我踩过一次坑显卡驱动装太旧nvidia-smi能跑但 CUDA 程序报版本不匹配。后来把 Windows 驱动升到最新问题立刻消失。所以我建议装完 WSL 之后顺手把显卡驱动更新到最新这一步能省掉后面大量排查时间。5.4 让终端接近 macOS 观感的字体与主题配置最后聊聊颜值虽然是次要的但每天面对十几个小时的界面舒服一点确实影响心情。接近 macOS 观感的关键其实不在主题配色而在字体的字形设计和间距。我的配置是这样的字体用 JetBrains Mono 或者 Maple Mono字号 12 到 13行高 1.2开启字体连字ligatures。配色用低饱和度的深色方案避免纯黑背景配纯白文字那种对比度太高看久了眼睛疼。Ubuntu 侧的PS1提示符可以简化一下把冗长的路径显示改成只显示当前目录名配置写在~/.bashrc里export PS1\[\e[32m\]\u\h\[\e[0m\]:\[\e[34m\]\w\[\e[0m\]\$ 想要更现代的体验可以上 zsh 加 oh-my-zsh但说实话如果你只是日常敲命令bash 加上合理的提示符配置已经够用装一大堆插件反而拖慢每次开终端的速度。6. 常见故障速查与排查实录前面讲的是顺路情况这一章讲的是翻车现场。我把这些年遇到频率最高的问题整理成表附上我的实际处理方式。6.1 安装卡慢、下载中断与网络相关故障wsl --install卡在下载阶段是最常见的问题表现是进度条长时间不动或者报超时错误。原因通常是发行版包体较大而下载源在国外。处理方式有几个换时间段重试凌晨确实快一些、用wsl --update单独更新内核内核包小很多、或者干脆走第 3 章说的离线导入。还有一个情况是安装完成了但wsl命令本身很慢才响应敲个命令要等两三秒。这通常和系统资源占用有关检查一下是不是有安全软件在实时扫描 WSL 的虚拟磁盘文件。把 WSL 相关目录加入排除列表之后会明显改善。现象可能原因处理方式下载进度长时间不动源站访问慢换时段重试或走离线导入报WslRegisterDistribution failed虚拟化未开或版本不符检查 BIOS 虚拟化开关、系统版本命令响应慢杀毒软件扫描虚拟磁盘把 WSL 目录加入排除列表装完找不到发行版商店缓存问题wsl --list --all检查后重新安装6.2 SSH 连接不上与端口转发排查WSL 里的 SSH 服务有个特点它监听的端口在 Windows 侧是可以通过localhost直接访问的微软做了自动转发。但很多人反馈连不上原因一般有三个。第一Ubuntu 里根本没装或没启动 SSH 服务sudo apt install -y openssh-server sudo service ssh start第二配置文件里PermitRootLogin或者PasswordAuthentication被禁掉了查/etc/ssh/sshd_config。第三端口冲突Windows 侧已经有个程序占了 22 端口这时候要改 WSL 里 SSH 的监听端口。还有一种情况是你在 WSL 里跑了某个 Web 服务浏览器访问localhost打不开。这时候先确认服务监听的是0.0.0.0而不是127.0.0.1后者在 WSL 2 的虚拟化网络下可能转发不到。改监听地址一般就能解决。6.3 中文乱码、解压乱码与编码相关问题压缩包解压出来文件名全是乱码这是从 Windows 打包、在 Linux 解压时的经典问题。根源是 Windows 上打包工具用了 GBK 编码写文件名而 Linux 按 UTF-8 去读。处理方式是解压时指定编码或者用能识别编码的工具。比如处理 zipunzip -O gbk archive.zip -d output/如果-O参数不支持不同发行版的 unzip 版本有差异可以先在 Windows 侧用支持 UTF-8 的打包工具重新压一次这是更省事的做法。终端里显示乱码则回到 4.2 节讲的 locale 和字体问题。两者容易混淆判断方法是用cat看文件内容乱码是编码问题用ls看文件名乱码是文件名编码问题。6.4 我踩过的几个非典型坑说几个不那么常见但很折腾人的。第一个是时间不同步。笔记本休眠唤醒之后WSL 里的时间可能和 Windows 差几个小时导致 Git 提交时间错乱、HTTPS 证书校验失败。解决办法是同步一下sudo hwclock -s第二个是wsl --shutdown之后网络断掉重进恢复正常这通常是 Windows 侧的网络驱动或者安全软件在切换网络时干扰了虚拟网卡重启一次 Windows 比反复重启 WSL 有效。第三个是文件句柄泄漏。长时间跑 Docker 容器之后你会发现 WSL 占的内存越来越多free -h显示缓存区巨大。这是 Linux 的正常行为缓存会按需回收不用手动清。但如果真到了影响 Windows 的地步wsl --shutdown是最彻底的解法代价是所有服务要重启。第四个是关于在 WSL 里跑 Elasticsearch、Redis 这类带内存要求的服务。WSL 的默认内存上限可能会让它们启动失败报max virtual memory areas vm.max_map_count is too low之类。处理方式是在/etc/sysctl.conf里加大限制或者直接在.wslconfig里给 WSL 更多内存。sudo sysctl -w vm.max_map_count262144这行只能临时生效写进配置文件才能持久化。提醒每次修改.wslconfig或者/etc/wsl.conf都必须执行wsl --shutdown再重新进入配置才会重新加载。直接在运行的实例里改看不到任何效果。6.5 什么时候该推倒重来最后分享一个判断经验什么时候该修什么时候该重装。我的标准是如果问题涉及系统级的组件损坏比如 apt 彻底坏掉、系统库被误删、locale 配置混乱到无法生成重装一个干净发行版的成本远低于修复。因为 WSL 的发行版本质就是一个 tar 包加一个虚拟磁盘删掉再导入只要几分钟。备份方式也很简单wsl --export定期导一次 tar 包放在别的盘上。我一般两周导一次体积几十 GB 但心里踏实。真出问题的时候wsl --unregister干掉旧的再wsl --import导回来十分钟之内环境就恢复到导出时的状态比现场排查省事得多。故障等级典型表现建议处理轻微某个命令报错、配置项写错直接改配置中等apt 依赖冲突、服务起不来尝试修复设时间上限严重系统库损坏、无法进入 shell导出数据后重装发行版灾难虚拟磁盘损坏从最近一次备份导入这套 WSL 加 Ubuntu 的组合我从最初的手忙脚乱到现在半小时能搭好一套完整开发环境中间交了不少学费。最想说的是两点一是把项目文件放在 Linux 侧的文件系统里这一个习惯能解决一半以上的性能抱怨二是提前配好.wslconfig和备份习惯前者让你平时用得舒服后者让你出事的时候不慌。剩下的就是多用命令敲熟了自然就有感觉了。
