通过

开始将 Visual Studio Code 与适用于 Linux 的 Windows 子系统配合使用

Visual Studio Code 以及 WSL 扩展使你可以直接从 VS Code 使用 WSL 作为全职开发环境。 您可以：

  • 在基于 Linux 的环境中进行开发
  • 使用特定于 Linux 的工具链和实用工具
  • 在 Windows 上运行和调试基于 Linux 的应用程序，同时保持对 Outlook 和 Office 等生产力工具的访问权限。
  • 使用 VS Code 内置终端运行所选 Linux 分发版
  • 利用 VS Code 功能，例如 Intellisense 代码完成、 linting、 调试支持、 代码片段和 单元测试
  • 使用 VS Code 的内置 Git 支持轻松管理版本控制
  • 直接在 WSL 项目上运行命令和 VS Code 扩展
  • 在 Linux 或装载的 Windows 文件系统（例如 /mnt/c）中编辑文件，而无需担心路径问题、二进制兼容性或其他跨 OS 挑战

安装 VS Code 和 WSL 扩展

  • 访问 VS Code 安装页 并选择 32 或 64 位安装程序。 在 Windows 上安装 Visual Studio Code（不在 WSL 文件系统中）。

  • 当系统提示在安装过程中 选择其他任务 时，请务必选中 “添加到 PATH ”选项，以便使用代码命令轻松在 WSL 中打开文件夹。

  • 安装 远程开发扩展包。 除了远程 - SSH 和开发容器扩展之外，此扩展包还包括 WSL 扩展，使你能够在容器、远程计算机上或 WSL 中打开任何文件夹。

重要

若要安装 WSL 扩展，需要 1.35 年 5 月版本 或更高版本的 VS Code。 不建议在没有 WSL 扩展的情况下在 VS Code 中使用 WSL，因为你将失去对自动完成、调试、linting 等的支持。有趣的事实：此 WSL 扩展安装在 $HOME/.vscode/extensions（在 PowerShell 中输入命令 ls $HOME\.vscode\extensions\ ）。

更新 Linux 分发版

某些 WSL Linux 分发版缺少 VS Code 服务器启动所需的库。 可以使用其包管理器将其他库添加到 Linux 分发版中。

例如，若要更新 Debian 或 Ubuntu，请使用：

sudo apt-get update

若要添加 wget（要从 Web 服务器检索内容）和 ca-certificates（若要允许基于 SSL 的应用程序检查 SSL 连接的真实性），请输入：

sudo apt-get install wget ca-certificates

在 Visual Studio Code 中打开 WSL 项目

从命令行

若要从 WSL 分发版打开项目，请打开分发的命令行并输入： code .

使用 VS Code 远程服务器打开 WSL 项目

从 VS Code 中

还可以使用快捷方式访问更多 VS Code WSL 选项： CTRL+SHIFT+P 在 VS Code 中打开命令面板。 如果键入 WSL ，你将看到可用的选项列表，允许你在 WSL 会话中重新打开文件夹，指定要在其中打开哪个分发版，等等。

VS Code 的命令面板

VS Code WSL 中的扩展

WSL 扩展将 VS Code 拆分为“客户端-服务器”体系结构，客户端（用户界面）在 Windows 计算机上运行，服务器（代码、Git、插件等）在 WSL 分发版中“远程”运行。

运行 WSL 扩展时，选择“扩展”选项卡将显示本地计算机与 WSL 分发版之间拆分的扩展列表。

安装本地扩展（如 主题）只需安装一次。

某些扩展（如 Python 扩展）或用于处理代码检查或调试任务的任何扩展必须单独安装在每个 WSL 发行版上。 如果本地安装了未安装在 WSL 分发版上的扩展，VS Code 将显示警告图标 ⚠以及绿色的“在 WSL 中安装”按钮。

VS Code 的 WSL 扩展与本地扩展对比

有关详细信息，请参阅 VS Code 文档：

  • 在 WSL 中启动 VS Code 时，不会运行 shell 启动脚本。 有关如何运行其他命令或修改环境的详细信息，请参阅此 高级环境设置脚本文章 。

  • 从 WSL 命令行启动 VS Code 时遇到问题？ 本 故障排除指南 包括有关更改路径变量、解决有关缺少依赖项的扩展错误、解决 Git 行结束问题、在远程计算机上安装本地 VSIX、启动浏览器窗口、阻止器 localhost 端口、Web 套接字不起作用、存储扩展数据的错误等的提示。

安装 Git （可选）

如果计划与他人协作，或在开源站点（如 GitHub）上托管项目，VS Code 支持使用 Git版本控制。 VS Code 中的“源代码管理”选项卡跟踪所有更改，并具有内置于 UI 中的常见 Git 命令（添加、提交、推送、拉取）。

若要安装 Git，请参阅 设置 Git 以使用适用于 Linux 的 Windows 子系统。

安装 Windows 终端（可选）

新的 Windows 终端支持多个选项卡（在命令提示符、PowerShell 或多个 Linux 分发版之间快速切换）、自定义键绑定（为打开或关闭选项卡、复制+粘贴等创建自己的快捷键）、表情符号☺和自定义主题（配色方案、字体样式和大小、背景图像/模糊/透明度）。 在 Windows 终端文档中了解更多信息。

  1. 在 Microsoft 应用商店中获取 Windows 终端：通过应用商店安装，会自动处理更新。

  2. 安装后，打开 Windows 终端并选择 “设置” 以使用 profile.json 该文件自定义终端。

其他资源

可能需要考虑的一些附加扩展包括：

  • 来自其他编辑器的键映射：如果你从另一个文本编辑器（如 Atom、Sublime、Vim、Emacs、Notepad++等）转换，这些扩展可以帮助你的环境更适应你的使用习惯。
  • 设置同步：使你能够使用 GitHub 跨不同安装同步 VS Code 设置。 如果你在不同的计算机上工作，这有助于在这些计算机之间保持你的工作环境一致。