如果你想在 Windows 11 上获得接近 Linux 的开发体验（包管理、命令行工具链、SSH/Node/Python 等），同时又希望编辑器与调试体验保持 VS Code 的顺滑，WSL2 + VS Code Remote 是目前最省事、兼容性也最好的组合之一。
建议准备：Windows 11（22H2+ 更佳）、可用的微软账号（用于安装发行版）、以及能稳定访问常用官网/文档的网络环境。
最简单的方式是用系统自带命令一键安装（管理员终端执行）：
wsl --install
安装完成后按提示重启，然后首次打开 Ubuntu 会让你创建 Linux 用户名与密码。之后你可以用下面命令查看发行版与版本：
wsl -l -v
如果看到 VERSION=2 就说明已经是 WSL2。
进入 Ubuntu 后，先做一次更新与基础工具安装：
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl ca-certificates build-essential
然后设置 Git 基本信息（按需替换）：
git config --global user.name "YourName"
git config --global user.email "you@example.com"
在 Windows 侧安装 VS Code 后，打开扩展市场搜索并安装 Remote - WSL。安装完成后有两种常用进入方式：
1）在 Ubuntu 终端里进入你的项目目录，然后运行：
code .
它会自动拉起 Windows 上的 VS Code，并以 WSL 远程模式连接当前发行版。
2）在 VS Code 里使用命令面板（Ctrl+Shift+P）选择“Remote-WSL: New Window”。
连接成功后，左下角会显示 WSL 字样；这时终端、Git、语言服务等都会运行在 Linux 侧，兼容性更好。
很多人卡在“速度慢/权限怪/路径看不懂”。记住两条原则：
1）开发项目尽量放在 Linux 文件系统里（例如 /home/<user>/projects），而不是 Windows 的 C:\ 盘映射目录。这样索引与文件监听更稳定，速度也更快。
2）需要在 Windows 与 WSL 之间互相访问文件时，用 WSL 的挂载路径（通常是 /mnt/c）或 Windows 的网络路径访问 WSL（例如资源管理器地址栏输入 \\wsl$）。
如果遇到脚本“无法执行/权限不足”，一般用下面命令给可执行权限即可：
chmod +x your- .sh
在 WSL 内启动的 Web 服务（如 3000/5173/8000 端口）通常可以直接在 Windows 侧用 http://localhost:端口 访问。若你修改了监听地址，建议显式绑定到 0.0.0.0：
npm run dev -- --host 0.0.0.0
这样同一台机器的 Windows 浏览器与调试器更容易访问到服务。
WSL 官方文档：https://learn.microsoft.com/zh-cn/windows/wsl/
VS Code Remote - WSL 文档：https://code.visualstudio.com/docs/remote/wsl
如果你想进一步把“环境”也版本化（例如 Node/Python/Go 的版本切换），建议在 WSL 内再引入一个版本管理工具（如 mise、asdf 等），但这属于进阶内容，可根据实际项目再选。
