Windows 11 WSL2 开发环境搭建:安装 Ubuntu、配置终端与 VS Code 远程开发

WSL2(Windows Subsystem for Linux 2)适合把 Linux 开发环境“装进”Windows:既能用 Linux 的包管理/工具链,又能保留 Windows 的日常软件生态。下面这套流程尽量走官方推荐路径,避免不必要的折腾。

1. 开启 WSL2(建议用一键安装)

Windows 11 大多数情况下可以直接一条命令完成安装与初始化(会自动开启所需组件并安装默认发行版)。

在 Windows Terminal 或 PowerShell(管理员)中执行:

wsl --install

如果你想指定发行版(例如 Ubuntu 22.04):

wsl --install -d Ubuntu-22.04

安装完成后按提示重启系统。

2. 初始化 Ubuntu:更新、创建用户、准备常用工具

首次启动 Ubuntu 会让你创建 Linux 用户名与密码。之后建议先更新系统索引与基础工具:

sudo apt update

sudo apt upgrade -y

再补一套常见工具(按需增减):

sudo apt install -y git curl wget unzip build-essential

提示:尽量把项目放在 Linux 文件系统里(例如 /home/你的用户名/),大型项目在 WSL 内部读写会更顺滑;跨到 Windows 盘(如 /mnt/c)会受文件系统差异影响。

3. 用 Windows Terminal 打造更顺手的终端体验

推荐使用 Windows Terminal 作为统一入口:可以为 Ubuntu 配置独立的主题、字体和启动目录。

几个实用设置思路:

1)把 Ubuntu profile 的“启动目录”设为 //wsl$/Ubuntu-22.04/home/你的用户名(或对应发行版路径)。

2)字体建议选择支持等宽与 Powerline 图标的字体(例如 Nerd Fonts 系列),避免提示符符号乱码。

3)如果你常用 Git,给终端提示符加上分支信息会很省心,但不要堆太多插件,WSL 启动会变慢。

4. VS Code 远程开发:Remote - WSL 的正确打开方式

在 Windows 侧安装 VS Code,然后安装扩展:Remote - WSL。之后你有两种常用进入方式:

方式A:在 Windows 中打开 VS Code,按 F1 输入并选择:

Remote-WSL: New Window

方式B:在 WSL 里进入项目目录后直接启动:

code .

VS Code 会自动把 Server 装在 WSL 内部,让语言服务、编译与调试都在 Linux 环境运行;同时仍能调用 Windows 的浏览器与桌面能力。

5. 常见坑与排查建议

网络代理与下载慢:尽量先确保 Windows 侧网络正常,再检查 WSL 的 DNS/代理设置,避免在 WSL 内单独“套娃”多层代理导致不可控。

磁盘占用:WSL2 的发行版是虚拟磁盘文件,长期使用会变大;定期清理 apt 缓存:

sudo apt autoremove -y

sudo apt clean

系统时间不同步:极少数情况下会影响 TLS/证书校验;重启 WSL 通常能解决:

wsl --shutdown

参考链接(工具地址)

https://learn.microsoft.com/zh-cn/windows/wsl/install

https://code.visualstudio.com/docs/remote/wsl

用户评论 (0)

登录后参与讨论

立即登录 注册账号

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

操作成功