Windows 11 WSL2 开发环境从零到顺手:安装 Ubuntu、终端配置与 VS Code 远程

适合谁:为什么建议用 WSL2

如果你需要在 Windows 上做 Web/后端/数据分析开发,但又离不开 Windows 的办公软件、外设驱动和游戏生态,WSL2 是目前性价比最高的折中方案:它提供接近原生 Linux 的体验,同时保留 Windows 的桌面环境。

这篇教程以 Windows 11 + Ubuntu 为例,目标是把环境搭到“能用、好用、可维护”。

准备工作:确认虚拟化与系统版本

WSL2 依赖虚拟化。大多数新电脑默认已开启,但如果安装时提示与虚拟机相关的错误,先在 BIOS/UEFI 中确认 Intel VT-x/AMD-V 已启用。

建议更新到较新的 Windows 11 版本,并在 Microsoft Store 更新“Windows Subsystem for Linux”。参考链接:https://learn.microsoft.com/zh-cn/windows/wsl/

安装与启用:一条命令完成 WSL2

以管理员身份打开 PowerShell(或 Windows Terminal),执行:

wsl --install

这条命令会自动启用所需组件并安装默认发行版。完成后按提示重启系统。

如果你想明确指定 Ubuntu 版本,可以先查看可安装列表:

wsl --list --online

然后安装指定发行版(示例):

wsl --install -d Ubuntu

首次启动 Ubuntu:创建用户与更新软件源

第一次打开 Ubuntu 会让你创建 Linux 用户名与密码(这是 Linux 内部账号,不等同于 Windows 账号)。进入系统后建议先更新:

sudo apt update

sudo apt upgrade -y

如果你需要 Git/构建工具:

sudo apt install -y git build-essential

Windows Terminal 配置:默认打开 WSL、改字体与主题

建议使用 Windows Terminal 来管理 PowerShell、CMD 与 WSL。打开 Terminal 设置后:

1) 把“默认配置文件”设为 Ubuntu(WSL)。

2) 选择更适合代码的等宽字体(如 Cascadia Mono / JetBrains Mono)。

3) 配色主题选你习惯的暗色/浅色方案,减少长时间使用的视觉疲劳。

Windows Terminal 参考:https://learn.microsoft.com/zh-cn/windows/terminal/

用 VS Code Remote 在 Linux 里写代码(推荐)

很多新手会把代码放在 Windows 文件夹里,再用 WSL 去跑,这样容易遇到权限、性能或换行符问题。更推荐:把项目放在 WSL 的 Linux 文件系统里,然后用 VS Code Remote 连接进去。

步骤:

1) 安装 VS Code。

2) 安装扩展“Remote - WSL”。扩展说明:https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl

3) 在 Ubuntu 里进入项目目录后执行:

code .

VS Code 会自动启动并连接到 WSL,后续终端、依赖安装、调试都在 Linux 环境中进行,体验更一致。

常用命令:发行版管理与基础维护

查看已安装发行版:

wsl -l -v

设置默认发行版(示例):

wsl --set-default Ubuntu

关闭所有 WSL 实例(遇到卡顿或想释放内存时):

wsl --shutdown

进入指定发行版(示例):

wsl -d Ubuntu

常见问题与排错要点

1) 网络/代理问题:优先保证 Windows 端网络正常,再考虑 WSL 内的 DNS/代理配置,避免在不了解原理时到处改系统文件。

2) 文件放哪更合适:开发项目尽量放在 Linux 文件系统(例如 /home/你的用户名/Projects),避免跨系统文件访问导致的性能下降。

3) 磁盘占用:WSL2 使用虚拟磁盘文件(VHDX),长期使用会增长。清理 APT 缓存可先做:

sudo apt autoremove -y

sudo apt clean

工具地址 / 参考链接

WSL 官方文档:https://learn.microsoft.com/zh-cn/windows/wsl/

Windows Terminal:https://learn.microsoft.com/zh-cn/windows/terminal/

VS Code Remote - WSL:https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl

用户评论 (0)

登录后参与讨论

立即登录 注册账号

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

操作成功