如果你需要在 Windows 11 上快速获得一个稳定、轻量、可复现的 Linux 开发环境（写代码、跑脚本、用包管理器装依赖、配合 VS Code 远程开发），WSL2 是目前最省心的选择之一：它运行在轻量虚拟化层之上，性能与兼容性比早期 WSL 更好，同时又保留了 Windows 的桌面生态。
本文会按“从 0 到可用”的顺序完成：启用 WSL2 → 安装 Ubuntu → 初始化包管理与基础工具 → 文件互访与路径习惯 → VS Code Remote 开发 → 常见坑排查。官方安装说明可参考：https://learn.microsoft.com/zh-cn/windows/wsl/install
建议使用 Windows 11（家庭版/专业版都可）。如果你在 BIOS/UEFI 里关闭了虚拟化（Intel VT-x / AMD-V），WSL2 可能无法正常启动。遇到相关报错时，优先回到 BIOS 打开虚拟化选项，再重启。
最简单的方式是在“以管理员身份运行”的 PowerShell 中执行：
wsl --install
安装完成后按提示重启。重启后，系统会引导你初始化 Ubuntu（设置用户名与密码）。你也可以在微软商店选择其他发行版；Ubuntu 官方页面：https://ubuntu.com/wsl
建议确认默认版本为 2，并查看已安装发行版：
wsl --set-default-version 2
wsl -l -v
如果看到 Ubuntu 的 VERSION 为 2，说明 WSL2 正常工作。
进入 Ubuntu 终端后，先更新索引与系统组件：
sudo apt update
sudo apt -y upgrade
然后装一套常用工具（按需取舍）：
sudo apt -y install git curl wget unzip build-essential ca-certificates
Git 相关配置可先做最小化设置：
git config --global user.name "YourName"
git config --global user.email "you@example.com"
开发环境最常见的问题不是“装不上”，而是“版本混乱”。如果你经常切换项目，建议优先用版本管理工具，而不是把系统全局装成一锅粥。
Node.js 可以考虑 nvm（使用前请阅读其文档与安装脚本来源，避免从不明链接复制粘贴）：https://github.com/nvm-sh/nvm
Python 建议优先使用系统自带的 python3 + venv，每个项目单独虚拟环境：
python3 --version
python3 -m venv .venv
source .venv/bin/activate
WSL2 下，你会同时看到两套文件系统：
1) Linux 文件系统：/home/你的用户名/（适合放代码与依赖，I/O 更稳定）
2) Windows 盘符挂载：/mnt/c/（方便访问下载/桌面文件，但大量小文件读写可能更慢）
建议：把需要频繁编译、装依赖、跑测试的项目放在 Linux 文件系统里，再通过编辑器远程连接；把“共享给 Windows 应用”的产物放到 /mnt/c。
在 Windows 安装 VS Code 后，装一个官方扩展“WSL”。官方说明：https://code.visualstudio.com/docs/remote/wsl
然后在 Ubuntu 中进入项目目录，执行：
code .
VS Code 会自动提示在 WSL 环境里打开当前目录，并把终端、依赖、调试都放到 Ubuntu 里运行。这种方式通常比在 Windows 端直接跑 Linux 依赖更省心。
1) 无法启动/提示虚拟化相关错误
检查 BIOS 虚拟化是否开启；确认 Windows 功能中已启用 WSL/虚拟机平台。必要时按微软文档逐项核对（链接见前文）。
2) 网络/代理导致 apt 很慢
优先确认网络环境与 DNS，必要时更换软件源或在公司网络下使用合规的网络配置。不要使用来路不明的“加速脚本”。
3) 访问 Windows 文件权限异常
尽量不要在同一个目录里同时用 Windows 工具和 Linux 工具对权限敏感的文件做改动（例如某些 node_modules）。将项目放在 Linux 文件系统能显著减少这类问题。
