开始通过适用于 Linux 的 Windows 子系统使用 Visual Studio Code

Visual Studio Code 以及 Remote - 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 上(不是在 WSL 文件系统中)安装 Visual Studio Code。

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

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

重要

若要安装 Remote-WSL 扩展,需要 VS Code 的 1.35 5 月发行版版本或更高版本。 不建议在没有 Remote-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 证书(允许基于 SSL 的应用程序检查 SSL 连接的真实性),请输入:

sudo apt-get install wget ca-certificates

在 Visual Studio Code 中打开 WSL 项目

从命令行中

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

Open WSL project with VS Code remote server

从 VS Code 中

还可以通过使用 VS Code 中的快捷方式 CTRL+SHIFT+P 调出命令面板,以访问更多 VS Code 远程选项。 如果随后键入 Remote-WSL,将看到可用的 VS Code 远程选项列表,使你可以在远程会话中重新打开文件夹,指定要在哪个发行版中打开,等等。

VS Code's command palette

VS Code Remote 内部的扩展

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

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

安装本地扩展(如主题)只需安装一次。

某些扩展(例如 Python 扩展或处理 linting 或调试等操作的任何扩展)必须单独安装在每个远程 WSL 发行版上。 VS Code如果本地安装的扩展未安装在 WSL 远程,则会显示警告图标 ,以及绿色的"在 ⚠ WSL 中安装"按钮。

VS Code with Remote - WSL extensions vs local extensions

有关更多信息,请参阅以下 VS Code 文档:

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

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

安装 Git(可选)

如果计划与其他人协作,或是在开放源代码站点(如 GitHub)上托管项目,则 VS Code 支持使用 Git 进行版本控制。 VS Code 中的“源代码管理”选项卡可跟踪所有更改,并直接在 UI 中内置了常见 Git 命令(add、commit、push、pull)。

若要安装 Git,请参阅设置 Git 以与适用于 Linux 的 Windows 子系统一起使用

安装 Windows 终端(可选)

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

  1. 在 Microsoft Store 中获取 Windows 终端:通过 Microsoft Store 进行安装时,将自动处理更新。

  2. 安装完成后,打开 Windows 终端并选择“设置”以使用 文件自定义终端。

其他资源

可能需要考虑的几个附加扩展包括:

  • 来自其他编辑器的键映射:如果是从另一个文本编辑器(如 Atom、Sublime、Vim、eMacs、Notepad++ 等)进行转换,则这些扩展可帮助你的环境对此进行适应。
  • 设置同步:可以使用 GitHub 在不同安装之间同步 VS Code 设置。 如果在不同的计算机上工作,这有助于在它们之间保持一致的环境。
  • Chrome 调试器:使用 Linux 在服务器端完成开发后,需要开发并测试客户端。 此扩展将 VS Code 编辑器与 Chrome 浏览器调试服务进行集成,以提高工作效率。