Windows 用 WSL2 安装 Ubuntu:开发环境与 VS Code Remote 全流程

适用场景:为什么推荐用 WSL2 做 Windows 上的 Linux 开发

如果你需要在 Windows 上跑 Node/Python/Go、编译依赖 Linux 的项目、或希望终端体验更接近服务器环境,WSL2 是目前最省心的方案:它是基于轻量虚拟化的 Linux 内核,兼容性比早期 WSL1 更好;同时又能和 Windows 文件、网络、剪贴板等进行联动。

第 1 步:确认系统版本并启用 WSL2

在 Windows 11(或已更新到支持 WSL 的 Windows 10)上,最简单的方式是直接安装。建议先用以下命令确认 WSL 是否已安装、发行版是否存在:

wsl --status

wsl -l -v

如果还未安装,可以执行:

wsl --install

安装完成后按提示重启。重启后再次运行 wsl -l -v,确认默认发行版为 WSL2(VERSION=2)。

第 2 步:安装 Ubuntu,并完成首次初始化

首次进入 Ubuntu 时会提示创建 Linux 用户名与密码。注意:这是 Linux 内部的账户,不同于你的 Windows 账号。初始化后,建议立即更新软件源与基础工具:

sudo apt update

sudo apt -y upgrade

sudo apt -y install build-essential curl git ca-certificates

第 3 步:把开发目录放在正确的位置(性能与稳定性关键)

很多人第一次用 WSL2 会把项目放在 /mnt/c/(也就是 Windows 盘符映射)下,然后遇到依赖安装慢、文件监听不稳定的问题。建议把主要开发项目放在 Linux 文件系统里,例如:

mkdir -p ~/projects

这样对 npm/pip/编译器/文件 watcher 会更友好;需要和 Windows 共享时,再把少量文件放到 Windows 目录或使用 Git 远程仓库同步。

第 4 步:用 VS Code Remote 连接 WSL(推荐工作流)

安装 VS Code 后,在 Windows 侧安装扩展 Remote - WSL,然后在任意 WSL 终端运行:

code .

VS Code 会自动在 WSL 内安装服务端并完成连接,你的终端、Git、语言服务器都在 Linux 环境里运行,编辑器界面仍在 Windows 上,体验非常丝滑。

第 5 步:网络、代理与 DNS 常见坑(排查思路)

如果你遇到 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

用户评论 (0)

登录后参与讨论

立即登录 注册账号

暂无评论,快来抢沙发吧~

操作成功