刚把一台新笔记本从 Win11 24H2 重装完照例第一件事就是装 WSL 跑 Ubuntu。这台机器我直接装了最新的 Ubuntu 24.04 LTS整个过程从敲命令到进入 shell 不到十分钟中途还顺手处理了一个老生常谈的wsl --install 卡住问题。如果你也是 Win11 用户想在 Windows 底下搞一个好用的 Linux 环境这篇文章就是给你准备的。先把这个东西是什么说清楚WSLWindows Subsystem for Linux是微软官方的 Linux 兼容层它不是虚拟机、也不是双系统而是直接在 Windows 内核之上跑一套完整的 Linux 用户态环境。你可以在 Win11 里开一个 Ubuntu 终端装软件、写代码、跑服务全部用 Linux 的方式操作同时又能直接访问 Windows 里的文件。对于开发者、运维、做安全分析的人还有大学里学 Linux 的同学这基本是 Win11 下最方便、最省资源的 Linux 方案。Ubuntu 24.04 LTS 是目前最新的长期支持版本官方支持到 2029 年稳定性和软件源都比旧版本靠谱得多所以新装环境我强烈建议直接上 24.04别再用 20.04 / 22.04 的老镜像了。下面我会从版本选型、安装前置准备、正式安装、离线安装兜底方案、装完后的配置到 VSCode 集成、常见报错排查完整走一遍。每一步都会说清楚为什么这么做以及在什么情况下会踩坑。1. 先搞清楚几个概念再决定怎么装1.1 WSL1 和 WSL2到底差在哪很多教程一上来就让你跑wsl --install但如果你理解 WSL1 和 WSL2 的本质区别后面遇到问题会更容易定位。WSL1 是纯系统调用翻译层把 Linux 的 syscall 转换成 Windows 内核的调用。它启动极快、文件 IO 性能好而且不占多少内存。但缺点也很致命很多依赖真正 Linux 内核特性的软件跑不了比如 Docker、systemd、FUSE 文件系统在 WSL1 下要么报错、要么各种别扭。WSL2 则是在 Hyper-V 虚拟化平台上跑一个轻量级 Linux 虚拟机用的是真正的 Linux 内核。所以 WSL2 的应用兼容性远远好过 WSL1Docker Desktop、systemd、BPF 这些都能正常用。代价是它本质是个 VM占用内存会比 WSL1 高一点跨文件系统访问的性能也慢一些。注意Win11 上默认安装的就是 WSL2。如果你的机器是好几年前的老电脑用wsl -l -v查出来某个发行版是 VERSION 1建议尽快升级成 2。1.2 为什么现在推荐 WSL2 Ubuntu 24.04 LTSUbuntu 24.04 LTS 发布于 2024 年 4 月代号 Noble Numbat。它比起 22.04 主要有几个变化内核升级到 6.8默认启用 TPM 支持GCC 13、Python 3.12、OpenJDK 21 这些开发工具链都更新了安装包管理也从老旧的libapt-pkg体系进一步迁移到了新的 deb822 格式源。你说 22.04 现在还维护着能不能用能用但新装环境没必要追旧。我把 24.04 和 22.04 对比一下你就清楚了对比项Ubuntu 22.04 LTSUbuntu 24.04 LTS支持截止2027 年2029 年默认内核5.156.8GCC 默认版本1113Python 默认版本3.103.12软件包格式传统 sources.listdeb822 格式systemd 集成需要额外配置开箱即用更稳这里特别说一下 systemd。WSL 在早期版本里不支持 systemd导致systemctl命令整个不可用Ubuntu 里很多服务管理方式都用不了。现在新版 WSL 默认就带 systemd 支持Ubuntu 24.04 在里面跑systemctl status会非常顺畅。我实际测试下来24.04 配合最新的 WSL 2.0 内核启动速度、内存占用、稳定性都在一个很舒服的状态。1.3 Win11 版本要求别忽略这个前提WSL 在 Win10 和 Win11 上都可以装但 Win11 的体验明显好得多尤其是新版 WSL 的图形界面支持WSLg和文件资源管理器集成Win10 老版本经常出问题。装之前你最好先确认一下 Windows 版本按Win R输入winver回车。系统会弹出一个关于 Windows的窗口里面能看到系统版本号和内部版本号。Win11 的正式版22H2 及以上基本都能正常跑最新的 WSL。如果你还在用 Win11 早期预览版建议先把系统更新到最新补丁再动 WSL很多玄学报错其实都是老版本 Windows 的锅。2. 安装前的准备三步做到位2.1 检查 BIOS 虚拟化是否开启WSL2 依赖虚拟化技术不管你是 Intel 还是 AMDCPU 的虚拟化功能必须打开。否则后面你会碰到经典的0x80370102报错。开机时按Del或者F2进 BIOS每个主板不一样一般是这两个。找 Advanced / CPU Configuration / VT-x 或 SVM Mode 之类的选项Intel 平台找Intel Virtualization Technology或VT-x设为 EnabledAMD 平台找SVM Mode设为 Enabled改完保存退出进 Windows 之后打开任务管理器切到性能标签页左下角选CPU看右下方有没有虚拟化已启用。如果显示已禁用说明 BIOS 里没改对或者没生效。我用过一台 ThinkPad 和一台 DIY 台式机都是 Intel 平台默认就开了虚拟化。但有些品牌机比如某些小型主机默认是关的这一步一定要确认。2.2 以管理员身份打开 PowerShell整个安装过程需要在管理员权限的 PowerShell 或 Windows Terminal 里执行。这不是矫情wsl --install要启用 Windows 可选功能Virtual Machine Platform、Windows Subsystem for Linux这些都需要提升权限。操作方式点开始菜单输入 PowerShell右键选择以管理员身份运行或者在 Windows Terminal 的设置里把默认终端改成 PowerShell然后开一个新标签它会自动提示提权。注意千万不要用普通的 CMD 窗口去跑wsl --install即使你能执行后面启用功能时也可能因为权限不足冒出来一长串错误。2.3 联网环境确认WSL 安装过程中需要从微软服务器下载内核组件和发行版镜像。国内网络环境有时候访问微软存储不太稳定表现为wsl --install卡在正在下载很久不动。这个我在第 4 章会专门讲怎么解决这里你只需要确认你的网络能正常打开微软商店并且没有挂什么特殊的全局代理设置。如果你在公司内网且内网有 HTTPS 代理策略建议提前配好系统代理或者留出绕过列表不然后面装发行版时容易下载失败。3. 正式安装一条命令搞定大部分事情3.1 最完美的起点wsl --install在管理员 PowerShell 里输入下面这一条命令然后回车wsl --install这条命令会做三件事启用 WSL 内核、启用虚拟机平台可选功能、自动安装默认的 Linux 发行版在 2024 年 4 月之后默认发行版就是 Ubuntu 24.04 LTS。执行完之后系统会提示你重启电脑。重启之后进系统会看到一个 Ubuntu 窗口自动弹出来让你设置用户名和密码。这条命令是微软官方推荐的装机方式也是从 Win11 全新安装后最顺滑的一条路。不过它有个缺点不可控。它装的是默认发行版不能指定版本号而且如果网络不好会卡得让人想砸电脑。所以我个人习惯是用显式参数来装。3.2 指定安装 Ubuntu 24.04稳准狠如果不想让系统替你决定装哪个发行版或者你明确就要 Ubuntu 24.04可以先看微软商店里现在有哪些版本可用wsl --list --online输出大概是这样的列表以下是可安装的有效分发版。 使用 -d 参数进行安装 NAME FRIENDLY NAME Ubuntu Ubuntu Ubuntu-22.04 Ubuntu 22.04 LTS Ubuntu-24.04 Ubuntu 24.04 LTS ...看到Ubuntu-24.04了吗这就是我们要的。执行wsl --install -d Ubuntu-24.04如果你已经执行过wsl --install但装的是别的发行版也可以用这条命令补充安装 24.04。它会先下载 Ubuntu 24.04 的 WSL 镜像然后自动注册发行版。下载体量大概几百 MB具体看网速。装完同样要重启一次然后进入首次配置。3.3 首次启动设置用户名和密码重启后你大概率会看到一个 Ubuntu 终端窗口自动打开或者你手动在开始菜单里找到新出现的Ubuntu 24.04.4 LTS也可能显示为Ubuntu图标点开。第一次启动会提示Installing, this may take a few minutes... Please create a default UNIX user account.这里设置的用户名不需要和 Windows 用户名一致它是 Linux 里的普通用户。输入一个你喜欢的英文小写用户名回车再输入两遍密码。密码输入的时候屏幕不会显示任何字符这是正常现象别以为键盘坏了。设置完成后你就进入了一个完整的 Ubuntu 24.04 shell。先用几个命令确认一下环境lsb_release -a uname -rlsb_release -a能看到 Ubuntu 24.04 LTSuname -r能看到 WSL2 的内核版本号一般会是6.6.x-microsoft-standard-WSL2这种格式说明 WSL2 内核已经就位。3.4 确认 WSL 本身也是最新版这一条很容易被忽略。WSL 分为两个部分Windows 组件和 Store 版本。新版 WSL 是通过 Microsoft Store 发布的版本号可以单独查看并更新wsl --version输出会有类似WSL 版本 2.4.4 内核版本 6.6.68.3如果版本号很老比如 1.x或者系统提示WSL 版本太旧请运行 wsl --update就执行wsl --update把 WSL 组件更新到最新版。这一步非常重要因为 systemd、Windows 文件资源管理器集成、VSCode 联动等很多特性都需要较新的 WSL 版本。提示如果你在旧版本 WSL 上跑 Ubuntu 24.04有可能会遇到 systemd 起不来、localhost端口转发失效等问题。新版本把很多坑都填了升级是最省事的解法。4. wsl --install 卡住离线安装方案兜底4.1 卡住的本质原因我遇到wsl --install太慢通常不是命令本身的问题而是它内部需要下载 Microsoft Store 的发行版包这个下载源在国内有时候抽风。表现就是终端卡在 Downloading 这个阶段十几分钟不动。如果卡住了不要反复 CtrlC 重试大概率还是卡同一个地方。先断开然后换离线导入的方式。这个方法的好处是只要你拿到了 Ubuntu 24.04 的 WSL 镜像文件一个.tar或.tar.gz包后续安装完全不需要经过微软商店直接本地导入。4.2 wsl --import 离线导入步骤首先在可用的网络环境下拿到 Ubuntu 24.04 的 WSL rootfs 镜像。ubuntu 官方发布了专门给 WSL 用的镜像文件名类似ubuntu-24.04-minimal-cloudimg-amd64-wsl.rootfs.tar.gz也可以从一些镜像站下载到。这个镜像体积不大大概 300-400 MB包含一个最简的 Ubuntu 24.04 文件系统。下载完成后把它放到一个固定目录比如D:\wsl-images\。接着在 PowerShell 里创建 WSL 发行版wsl --import Ubuntu-24.04 D:\wsl\Ubuntu-24.04 D:\wsl-images\ubuntu-24.04-minimal-cloudimg-amd64-wsl.rootfs.tar.gz --version 2这里解释一下参数第一个参数是发行版名称可以随便起Ubuntu-24.04只是我起的名字第二个参数是 WSL 虚拟磁盘存放位置建议放到非系统盘避免以后 C 盘爆炸第三个参数是镜像文件路径--version 2表示用 WSL2 架构。导入完成后启动它wsl -d Ubuntu-24.04这种方式导入的 rootfs 默认会以root用户登录并且不会走 Ubuntu 首次启动的账号设置向导。所以导入完了还需要自己建一个普通用户。4.3 离线导入后的用户初始化进入 shell 后先确认当前身份是 root。然后创建用户并加入 sudo 组useradd -m -s /bin/bash yourname passwd yourname usermod -aG sudo yourname注意Debian 系Ubuntu 也是里-aG sudo是必须的否则你的普通用户没有sudo权限。接下来设置默认登录用户编辑/etc/wsl.confvim /etc/wsl.conf写入[user] defaultyourname保存后退出在 PowerShell 里执行wsl --terminate Ubuntu-24.04重启发行版再进去就是你的普通用户了。这套流程我实测过多次比官方向导多一点手动步骤但完全可控适合网速不友好的场景。5. 装完立刻要做的几项配置5.1 换 apt 源别让 apt 卡成幻灯片Ubuntu 的默认 apt 源指向国外服务器在国内环境下执行apt update经常超时。换国内镜像源是装机后的第一件事。Ubuntu 24.04 和旧版本有点不一样它不再使用/etc/apt/sources.list作为主配置文件而是改用/etc/apt/sources.list.d/ubuntu.sources并且是 deb822 格式。很多老教程还在让你改sources.list在 24.04 上不够准确。备份原始文件sudo cp /etc/apt/sources.list.d/ubuntu.sources /etc/apt/sources.list.d/ubuntu.sources.bak然后用编辑器打开它把里面的http://archive.ubuntu.com/ubuntu/替换成你所在区域访问快的镜像地址。以清华源为例完整的替换文件内容大概是Types: deb URIs: https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ Suites: noble noble-updates noble-backports Components: main restricted universe multiverse Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg保存后执行sudo apt update sudo apt upgrade -y这一步会拉取最新的软件包索引并把你刚装的系统更新到最新状态。我在国内网络实测换源后 apt 的速度有质的提升尤其是装 Python 包依赖、编译工具链的时候。注意如果你用 WSL在 Windows 宿主上也配置了某个 HTTP 代理apt 可能会受影响。换源之后一般不需要配置Acquire::http::Proxy但如果 apt 还是走代理且失败可以用sudo apt -o Acquire::http::Proxyfalse update临时验证一下。5.2 确认 systemd 是开启状态新版 WSL 默认开启 systemd但如果你用的是旧版 WSL 或者离线导入的发行版这一步要显式确认。编辑/etc/wsl.confsudo vim /etc/wsl.conf确保有如下内容[boot] systemdtrue保存后在 PowerShell 里执行wsl --terminate Ubuntu-24.04然后重新进入 WSL用下面命令验证systemctl list-units --typeservice | head -20能看到一堆服务列表说明 systemd 已经接管了系统。开启 systemd 的价值在于你可以在 Ubuntu 里用systemctl管理 SSH、Docker、Nginx 等服务整个使用习惯和一台真正的 Linux 服务器完全一致。5.3 Windows 与 WSL 的文件互通技巧WSL2 中的 Linux 文件系统和 Windows 文件系统是隔离的但互相能访问。在 WSL 里访问 Windows 文件路径是/mnt/c/Users/你的用户名/Desktop在 Windows 里访问 WSL 文件可以在资源管理器地址栏输入\\wsl$\Ubuntu-24.04直接打开 Linux 根目录一个很实用的技巧在 WSL 的 home 目录下建一个符号链接指向 Windows 桌面这样两边文件随时互通ln -s /mnt/c/Users/你的用户名/Desktop ~/Desktop不过要提醒你跨文件系统读写性能有损耗尤其是大量小文件 IO。日常代码项目建议直接放在 WSL 的 Linux 文件系统内也就是~/project这种目录而不是放到/mnt/c底下。VSCode 的 WSL 插件、Docker 的数据卷在 Linux 文件系统上速度会快很多。5.4 给 WSL 固定一个内存上限WSL2 默认会吃掉机器一半的内存或者更多取决于 Windows 版本和配置。如果你内存不是特别大比如 16GB跑个编译任务就可能导致 Windows 卡顿。解决方案是在C:\Users\你的用户名\.wslconfig文件里做限制。如果文件不存在手动创建一个内容示例[wsl2] memory8GB processors4 swap4GB保存后执行wsl --shutdown再重新进入资源限制就生效了。我的机器是 64GB 内存平时不开限制但笔记本上只有 32GB 的时候我一般设到 8GB 或 12GB给 Windows 留下充足的余量。这个文件对 WSL2 性能调优很有用具体数值按自己机器配置来。6. 开发场景VSCode、Docker、常用工具一步到位6.1 在 VSCode 里用 WSL 写代码把 WSL 装好之后最常见的用法就是用 VSCode 连进去写代码。你只需要在 Windows 上安装 VSCode然后装一个扩展WSL微软官方出品扩展 ID 是ms-vscode-remote.remote-wsl。装完扩展后在 WSL 终端里进入你的项目目录执行code .VSCode 会自动识别 WSL 环境并启动一个远程开发窗口左下角会显示WSL: Ubuntu-24.04。这样你打开的终端、解释器、编译器全部都是 Linux 环境但界面还是在 Windows 的 VSCode 里。我用这个方式写 Python、Go、Rust体验和原生 Linux 开发几乎没有差别。唯一要注意的是VSCode Server 首次连接需要下载一些组件如果网络不佳也会卡多试几次或者配置好镜像源一般能过。6.2 在 WSL 里装 DockerWSL2 最常见的搭档就是 Docker。装 Docker 有两种方式第一装 Docker Desktop for Windows它内部会使用 WSL2 作为后端。这种方式操作简单但 Docker Desktop 商用有授权问题个人用没问题公司里用就要注意 license 了。第二纯在 WSL 里装 Docker Engine不装 Docker Desktop。这种方式更接近服务器环境也更省资源。我推荐第二种安装步骤sudo apt update sudo apt install -y docker.io sudo systemctl enable docker --now sudo usermod -aG docker $USER说明一下Ubuntu 24.04 的官方源里有docker.io包虽然版本可能不如 Docker 官方源新但稳定够用。如果你需要最新版 Docker可以按 Docker 官方文档的 apt 源方式安装注意它的源是download.docker.com网络可达性看各人环境。安装完成后新开一个终端让usermod生效执行docker run hello-world能正常输出说明 Docker 已经跑起来了。有了 WSL 里的 Docker写 Dockerfile、跑容器、搭数据库全部在本地完成非常顺手。6.3 安全分析、逆向等场景的小工具如果你平时做固件分析、CTF、逆向工程WSL 里的 Ubuntu 24.04 就是一把瑞士军刀。典型工具链可以直接装sudo apt install -y binwalk file hexdumpbinwalk是固件提取、文件签名扫描的利器。在 WSL 里跑 binwalk 跟真 Linux 完全一样而且因为 WSL2 有真正的 Linux 内核binwalk -e提取固件时遇到嵌套文件系统也能正常处理。我试过用 WSL 解包一个 100MB 的路由器固件速度和原生 Linux 没有区别。另一个非常实用的是在 WSL 里配置 SSH 密钥并连接远程 Linux 服务器。你可以把~/.ssh目录从 Windows 拷贝过来复用也可以直接在 WSL 里重新生成。多个环境身份隔离反而更清晰我一般把开发相关的 SSH key 放 WSL 里Windows 上只留日常个人用途的。7. 常见报错和排查实录7.1 报错速查表做技术的人都明白装环境大概率不会一次顺利。我把经常遇到的几个报错整理成了下面的表格你可以直接对着查报错信息原因解决方式0x80370102BIOS 虚拟化未开启进 BIOS 打开 VT-x / SVM ModeWSL 2 requires an update或版本太旧WSL 组件过旧管理员 PowerShell 执行wsl --updateError code: Wsl/WSL_E_DISTRO_NOT_FOUND发行版未注册或名称错误wsl --list --online查看正确名称后重新安装The service cannot be startedWindows 服务未启动管理员 PowerShell 执行Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-LinuxJemalloc或Cannot find user离线导入后用户配置错误按 4.3 的步骤创建用户并配置/etc/wsl.confBad magic number in super-block导出的 rootfs 文件不完整重新下载镜像文件校验完整性后再导入7.2 Your version of WSL is too old 的破解方法在某次启动 WSL 时终端直接弹了一行提示Your version of Windows Subsystem for Linux is too old. Please run wsl --update to update to the latest version.这个错误通常出现在较老 Windows 版本或从未更新过 WSL 的机器上。解决办法特别简单在管理员 PowerShell 里执行wsl --update它会去下载最新的 WSL 稳定版内核。如果这一步下载仍然很慢你也可以通过微软官网手动下载 WSL 安装包或者从 Microsoft Store 里搜 Windows Subsystem for Linux 更新应用。更新完成后重新打开终端问题就没了。7.3 WSL 占空间越来越大怎么迁移到 D 盘WSL2 的虚拟磁盘文件ext4.vhdx默认存在 C 盘用户目录下时间长了会越来越大。尤其你装了一堆开发环境、Docker 镜像后C 盘动不动就多出几十 GB。解决办法是把整个发行版迁移到其他盘。在 PowerShell 里先导出wsl --export Ubuntu-24.04 D:\wsl-backup\ubuntu-24.04.tar然后注销原发行版wsl --unregister Ubuntu-24.04再导入到 D 盘wsl --import Ubuntu-24.04 D:\wsl\Ubuntu-24.04 D:\wsl-backup\ubuntu-24.04.tar --version 2注意--unregister会把你 WSL 里的所有数据清空导出一定要做在前面。导入完成后默认用户会变成 root你需要按照 4.3 节的步骤重新配置默认用户。如果嫌麻烦也可以在导入后直接进入wsl -u root修改/etc/wsl.conf。7.4 网络连不上 / localhost 访问不到WSL2 的 NAT 模式偶尔会出现网络异常症状是ping 8.8.8.8通但apt update超时或者 Windows 访问 WSL 里启动的 Web 服务localhost:8080失败。第一步先重启 WSL 看是否恢复wsl --shutdown第二步检查 WSL 里的/etc/resolv.conf是否正常。如果 DNS 配置有问题可以临时手动设置sudo sh -c echo nameserver 223.5.5.5 /etc/resolv.conf但注意WSL 可能会在重启后覆盖这个文件。较新版本在/etc/wsl.conf里可以配置[network] generateResolvConf false来禁止自动生成 DNS 配置不过一般用户不大需要动这里默认 DNS 在多数网络下是能用的。至于 localhost 访问新版 WSL 默认支持 localhost 转发Windows 浏览器直接访问http://localhost就能到 WSL 里的服务。如果不行优先检查 WSL 里的服务是否监听在0.0.0.0而不是127.0.0.1。7.5 中文显示 / 输入法的一点经验WSL 默认不带中文图形界面输入法。如果你需要在 WSLg 图形界面应用里输入中文可以装 fcitx5sudo apt install -y fcitx5 fcitx5-chinese-addons装完在/etc/environment里加入GTK_IM_MODULEfcitx QT_IM_MODULEfcitx XMODIFIERSimfcitx然后重启 WSL启动 fcitx5。坦白说这个过程在 WSLg 里还能用但体验不如 Windows 原生中文输入法。如果你只是用 WSL 做纯命令行开发其实不需要折腾输入法复制粘贴中文内容完全没障碍。装 Pycharm 之类的 GUI 工具时也别忘了先设置好环境变量否则菜单里中文可能出现乱码。我自己用下来最顺手的方式是Windows 上用微软拼音WSL 终端里只跑命令和代码中文输入只在需要写注释时临时切一下体验非常顺滑。最后再分享一点个人体会我把 WSL 当作日常开发的主力环境已经用了好几年从 WSL1 一路用到 WSL2 Ubuntu 24.04。最大的感受是微软这几年在 WSL 上的投入是实打实的新版本已经把早期能用变成了好用。你现在在 Win11 上装 WSL 2 Ubuntu 24.04 LTS基本上就是获得了一台可以随时启停的轻量 Linux 服务器跑代码、跑服务、跑 Docker、分析固件都能在 Windows 的壳里直接完成还不占多少资源。如果只让我给你一条建议装完系统后先别急着装一堆花哨工具先把 apt 源换好、systemd 确认开起来、VSCode 联动搞定这三件事做好了后面所有开发工作都会很顺手。至于那些偶尔冒出来的小报错绝大多数重启 WSL 就能解决再不行就看一眼这篇文章第 7 章的速查表基本都能对症下药。
