将 Visual Studio Code 与 WSL 配合使用

Visual Studio Code 与 WSL 扩展配合后，可以直接把 WSL 当作日常开发环境。你可以：

• 在基于 Linux 的环境中开发。
• 使用 Linux 专用的工具链和实用程序。
• 在 Windows 中运行和调试基于 Linux 的应用，同时继续使用 Outlook、Office 等生产力工具。
• 通过 VS Code 内置终端运行你选择的 Linux 发行版。
• 使用 VS Code 的 IntelliSense 代码补全、代码检查、调试支持、代码片段和单元测试。
• 借助 VS Code 内置的 Git 支持管理版本控制。
• 直接针对 WSL 项目运行命令和 VS Code 扩展。
• 编辑 Linux 文件系统或挂载的 Windows 文件系统中的文件，例如 /mnt/c，通过集成环境处理路径、二进制兼容性等跨操作系统问题。

安装 VS Code 和 WSL 扩展

访问 VS Code 下载页，选择与你的系统体系结构匹配的 Windows 安装程序。将 Visual Studio Code 安装在 Windows 上，不要把编辑器本体装在 WSL 文件系统中。

安装过程中出现“选择附加任务”（Select Additional Tasks）时，勾选“添加到 PATH”（Add to PATH）。这样就可以在 WSL 中使用 code 命令打开文件夹。

安装 WSL 扩展。如果还需要连接远程计算机或使用开发容器，可以安装 Remote Development 扩展包；这个扩展包包含 WSL、Remote – SSH 和 Dev Containers。

更新 Linux 发行版

部分 WSL Linux 发行版缺少 VS Code 服务器启动所需的库。可以使用该发行版的包管理器补充这些依赖。

例如，在 Debian 或 Ubuntu 中，更新软件包索引：

sudo apt-get update

安装 wget 和 ca-certificates。前者用于从 Web 服务器获取内容，后者让使用 SSL 的应用能够验证 SSL 连接的真实性：

sudo apt-get install wget ca-certificates

在 Visual Studio Code 中打开 WSL 项目

从命令行打开

打开 WSL 发行版的命令行，在项目目录输入 code .，即可打开当前目录中的项目。

从 WSL 命令行通过 code . 打开项目，VS Code 连接 WSL 中的远程服务器（原图含身份信息，交付稿不嵌入。）

在 WSL 项目目录运行 code . 后，VS Code 打开该目录并连接该发行版；连接成功后，左下角显示 WSL 发行版。

从 VS Code 打开

在 VS Code 中按 Ctrl + Shift + P 打开命令面板，再输入 WSL。命令列表会提供多种选项，例如在 WSL 会话中重新打开文件夹，或指定要连接的发行版。

VS Code WSL 中的扩展

WSL 扩展采用客户端与服务器架构：客户端，也就是用户界面，运行在 Windows 计算机上；服务器，包括代码、Git、插件等，则运行在 WSL 发行版中。

使用 WSL 扩展时，打开“扩展”选项卡，可以看到分别属于本地计算机和 WSL 发行版的扩展列表。

本地扩展，例如主题，只需安装一次。

另一些扩展，例如 Python 扩展，以及负责代码检查或调试的扩展，需要在每个要使用的 WSL 发行版中单独安装。如果某个扩展只安装在本地，尚未安装到当前 WSL 发行版，VS Code 会显示警告图标 ⚠，以及绿色的“在 WSL 中安装”（Install in WSL）按钮。

扩展列表分别显示本地安装和 WSL 发行版中的安装情况（原图含个人路径，交付稿不嵌入。）

更多细节可以参考 VS Code 文档：

• 在 WSL 中启动 VS Code 时，不会运行 shell 启动脚本。需要额外执行命令或修改环境时，参阅高级环境设置脚本。
• 如果无法从 WSL 命令行启动 VS Code，参阅故障排除指南。其中包括 PATH 变量、扩展依赖缺失、Git 行尾、在远程计算机安装本地 VSIX、启动浏览器窗口、localhost 端口阻塞、WebSocket 无法工作、扩展数据保存错误等问题。

安装 Git（可选）

如果需要与他人协作，或把项目托管到 GitHub 等开源平台，可以使用 VS Code 的 Git 版本控制支持。“源代码管理”选项卡会跟踪文件变更，并提供常见的 Git 操作，例如添加、提交、推送和拉取。

安装方法见在 WSL 上使用 Git 入门。

安装 Windows Terminal（可选）

Windows Terminal 支持多个选项卡，可以在命令提示符、PowerShell 和不同 Linux 发行版之间快速切换。它还支持自定义键绑定、表情符号，以及配色方案、字体样式和大小、背景图片、模糊效果、透明度等主题设置。Windows 11 预装了 Windows Terminal；更多说明见 Windows Terminal 文档。

1. 从 Microsoft Store 安装 Windows Terminal。通过商店安装后，更新会自动处理。
2. 安装完成后打开 Windows Terminal，选择“设置”，通过 settings.json 自定义终端。

其他资源

• VS Code 的 WSL 文档
• VS Code 的 WSL 教程
• 远程开发提示与技巧
• 将 Docker 与 WSL 2 和 VS Code 配合使用
• 在 VS Code 中使用 C++ 和 WSL

还可以考虑以下扩展和功能：

• 其他编辑器的键映射：如果你从 Atom、Sublime、Vim、Emacs、Notepad++ 等编辑器转过来，可以用这些扩展延续熟悉的操作习惯。
• Settings Sync：VS Code 内置设置同步功能，可以通过 GitHub 或 Microsoft 帐户，在不同计算机之间同步设置、扩展和键绑定。

原始文档由 Microsoft 官方文档团队及贡献者提供：Get started using Visual Studio Code with Windows Subsystem for Linux，官方中文版。正文与教学图按文档仓库的 CC BY 4.0 许可证使用；本稿整理了中文措辞与 Markdown 格式，保留原文全部正文小节、命令及教学图链接。未获得 Microsoft 的背书。

代码示例按仓库的 MIT 许可证使用。