如果你需要在 Windows 上跑 Node/Python/Go、编译依赖 Linux 的项目、或希望终端体验更接近服务器环境,WSL2 是目前最省心的方案:它是基于轻量虚拟化的 Linux 内核,兼容性比早期 WSL1 更好;同时又能和 Windows 文件、网络、剪贴板等进行联动。
在 Windows 11(或已更新到支持 WSL 的 Windows 10)上,最简单的方式是直接安装。建议先用以下命令确认 WSL 是否已安装、发行版是否存在:
wsl --status
wsl -l -v
如果还未安装,可以执行:
wsl --install
安装完成后按提示重启。重启后再次运行 wsl -l -v,确认默认发行版为 WSL2(VERSION=2)。
首次进入 Ubuntu 时会提示创建 Linux 用户名与密码。注意:这是 Linux 内部的账户,不同于你的 Windows 账号。初始化后,建议立即更新软件源与基础工具:
sudo apt update
sudo apt -y upgrade
sudo apt -y install build-essential curl git ca-certificates
很多人第一次用 WSL2 会把项目放在 /mnt/c/(也就是 Windows 盘符映射)下,然后遇到依赖安装慢、文件监听不稳定的问题。建议把主要开发项目放在 Linux 文件系统里,例如:
mkdir -p ~/projects
这样对 npm/pip/编译器/文件 watcher 会更友好;需要和 Windows 共享时,再把少量文件放到 Windows 目录或使用 Git 远程仓库同步。
安装 VS Code 后,在 Windows 侧安装扩展 Remote - WSL,然后在任意 WSL 终端运行:
code .
VS Code 会自动在 WSL 内安装服务端并完成连接,你的终端、Git、语言服务器都在 Linux 环境里运行,编辑器界面仍在 Windows 上,体验非常丝滑。
如果你遇到 apt 拉取失败、容器镜像下载慢或域名解析异常,可以按以下思路排查:
1) 先确认 Windows 是否能正常访问网络;
2) 在 WSL 内检查解析:
cat /etc/resolv.conf
3) 如果公司网络/代理环境复杂,建议优先按官方指引配置,并尽量保持 WSL 与 Windows 的代理设置一致,避免“Windows 能上网、WSL 不能”的割裂。
WSL 安装与管理(微软官方文档):https://learn.microsoft.com/zh-cn/windows/wsl/install
VS Code Remote - WSL(官方文档):https://code.visualstudio.com/docs/remote/wsl