WSL2 + Ubuntu 开发环境搭建:从安装到终端提效的一套配置

适合谁:为什么用 WSL2 跑 Ubuntu

如果你在 Windows 上写代码,但又经常需要 Linux 工具链(Node/Python/Go、git、ssh、grep、make 等),WSL2 是一套非常省心的方案:它把 Linux 作为一个轻量虚拟机集成进系统,文件系统、网络与终端体验都更贴近原生开发环境,同时又保留 Windows 的软件生态。

本文目标:在 Windows 11(Windows 10 也可)上安装 WSL2 + Ubuntu,并完成常用基础配置(更新、换源、终端、VS Code 联动),让它成为日常主力开发环境。

步骤1:开启必要条件(虚拟化/WSL 组件)

先确认 BIOS/系统已开启虚拟化(不同品牌叫法可能是 Intel VT-x / AMD-V)。在 Windows 任务管理器 → 性能 → CPU 中也能看到“虚拟化:已启用”。

推荐使用官方安装命令(管理员权限 PowerShell):

wsl --install

如果你已经装过 WSL,建议检查版本与默认发行版:

wsl -l -v wsl --set-default-version 2

步骤2:安装 Ubuntu 并完成初始账号设置

执行 wsl --install 后通常会自动安装 Ubuntu,并在首次启动时让你创建 Linux 用户名/密码。这个账号是 WSL 内部的 Linux 用户,与 Windows 登录账户不同。

如果你想安装指定版本(示例):

wsl --list --online wsl --install -d Ubuntu

步骤3:基础系统更新与常用工具安装

进入 Ubuntu 后,先把系统更新到最新:

sudo apt update sudo apt upgrade -y

再补齐常用工具(按需选择):

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

如果你需要更好的中文体验(按需):

sudo apt install -y locales sudo locale-gen zh_CN.UTF-8

步骤4:设置更顺手的终端(Windows Terminal + 默认进入 Ubuntu)

Windows Terminal 是 WSL 的最佳搭档:标签页管理、多窗格、主题与字体都更舒服。安装后打开 Terminal,你会看到 Ubuntu 配置文件;建议把它设置为默认启动项,并给它换一个易识别的配色与图标。

一个实用的小习惯:把常用项目放在 Linux 家目录(如 ~/code),避免在不同文件系统间频繁切换。

步骤5:VS Code 与 WSL 的无缝联动(Remote - WSL)

在 Windows 侧安装 VS Code,然后安装扩展 Remote - WSL。之后你可以在 WSL 里进入项目目录,直接打开:

cd ~/code code .

VS Code 会自动在 WSL 环境中启动后端(语言服务、终端、调试器等),你写代码的体验会非常接近原生 Linux。

步骤6:文件放哪儿更合理(避免踩坑)

建议优先把开发项目放在 Linux 文件系统(例如 /home/你的用户名/code)。把项目放在 Windows 盘(如 /mnt/c/...)也可以,但在大量小文件(node_modules、依赖缓存)场景下可能更慢。

当你需要在 Windows 侧访问 WSL 文件时,可以使用资源管理器打开:

explorer.exe .

步骤7:日常提效小清单

最后给一份“装完就能用”的提效检查表,你可以按需取用:

  • 给 git 配置用户名与邮箱:git config --global user.name "你的名字"、git config --global user.email "邮箱"
  • 生成并配置 SSH Key(用于 Git 仓库):ssh-keygen -t ed25519
  • 用 tmux 管理多会话:sudo apt install -y tmux
  • 用 fzf 做模糊搜索(可选):sudo apt install -y fzf
  • 定期检查 WSL 状态:wsl -l -v,需要时重启:wsl --shutdown

结语:一套稳定、可迁移的 Windows 开发底座

WSL2 的价值在于“稳定 + 够用 + 好迁移”:你换电脑、重装系统、或者想把环境复制给同事时,都能把这套步骤快速复刻出来。建议你把常用安装清单(语言版本、依赖、VS Code 扩展)记录下来,后续迭代会越来越省心。

用户评论 (0)

登录后参与讨论

立即登录 注册账号

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

操作成功