VSCode搭配WSL2开发环境搭建指南（含SSH配置）

最新推荐文章于 2026-04-29 21:59:16 发布

原创

最新推荐文章于 2026-04-29 21:59:16 发布 · 235 阅读

在Windows 10上构建无缝融合的Linux开发环境：WSL2与VSCode深度整合实践

作为一名长期在Windows平台上耕耘的开发者，你是否曾无数次羡慕macOS或纯Linux环境下的那种“开箱即用”的终端体验和开发工具链？虚拟机笨重，双系统切换麻烦，远程服务器又有延迟。直到微软推出了WSL2，这一切才真正迎来了转机。它不再是那个功能受限的“子系统”，而是一个近乎原生的Linux内核，与Windows实现了前所未有的深度集成。今天，我们就来聊聊如何将WSL2与当今最流行的代码编辑器VSCode结合起来，打造一个既拥有Windows的便利性，又具备Linux强大命令行能力的“梦幻”开发环境。无论你是前端开发者需要Node.js生态，还是后端工程师依赖Docker和数据库服务，这套组合拳都能让你事半功倍。

1. 基石：从零开始部署与优化WSL2

在一切开始之前，确保你的Windows 10版本是1903（内部版本18362）或更高。更推荐使用Windows 10版本2004（内部版本19041）及以上，以获得最完整的WSL2体验。你可以通过在开始菜单搜索“winver”来快速确认。

1.1 启用WSL2与安装Linux发行版

过去，启用WSL需要手动打开一堆Windows功能。现在，整个过程可以通过一行命令在管理员权限的PowerShell中完成，这大大简化了流程。

wsl --install

这个命令会默认执行以下操作：启用“适用于Linux的Windows子系统”和“虚拟机平台”这两个必需的Windows功能，将WSL的默认版本设置为2，并安装一个默认的Linux发行版（通常是Ubuntu）。安装完成后，系统会提示你重启计算机。

重启后，一个Ubuntu终端窗口会自动弹出，等待你设置新用户的用户名和密码。这个账户将是你在WSL子系统中的管理员（sudo）账户。

提示：如果你希望安装其他发行版，如Debian、Kali Linux或openSUSE，可以先使用 wsl --install -d <发行版名称> 命令。也可以先执行 wsl --install 安装默认版，再通过Microsoft Store搜索并安装其他发行版。

安装完成后，建议立即检查WSL版本，确保它运行在WSL2模式下。

wsl -l -v

你应该能看到类似下面的输出，确认你的发行版后面跟着“2”：

  NAME            STATE           VERSION
* Ubuntu          Running         2

如果版本显示为1，可以使用以下命令进行转换：

wsl --set-version Ubuntu 2

1.2 系统迁移与基础环境调优

默认情况下，WSL2的虚拟硬盘文件（VHDX）存放在C盘。随着你安装的软件和依赖增多，这个文件会不断膨胀，可能挤占宝贵的系统盘空间。因此，将其迁移到其他分区是一个明智的预防措施。

迁移WSL发行版到非系统盘：

首先，关闭所有WSL实例：
```
wsl --shutdown
```
导出你的发行版到一个tar归档文件：
```
wsl --export Ubuntu D:\WSL\ubuntu_backup.tar
```
这会在D盘的WSL文件夹下创建一个备份文件。
注销当前的发行版：
```
wsl --unregister Ubuntu
```
别担心，这只是注销了WSL的注册信息，我们刚刚导出的tar文件包含了全部数据。
在目标位置重新导入发行版：
```
wsl --import Ubuntu D:\WSL\Ubuntu D:\WSL\ubuntu_backup.tar --version 2
```
这条命令在D:\WSL\Ubuntu目录下创建了新的虚拟硬盘，并从备份文件中恢复系统。
设置默认用户：重新导入后，默认会以root身份登录。要恢复