使用 Visual Studio Code 进行远程开发

2019 年 5 月 2 日，由 VS Code 团队发布，@code

TL;DR（太长不看）

今天，我们很高兴宣布推出 Visual Studio Code 的三个新扩展的预览版，这些扩展可以在容器中、在物理或虚拟机上远程以及使用 适用于 Linux 的 Windows 子系统 (WSL) 实现无缝开发。您可以通过安装 远程开发扩展包立即开始使用。

注意：目前您需要使用 Insiders 构建版本，但远程开发支持最终将在稳定版本中提供。

请继续阅读以了解我们是如何走到这一步的。

开发趋势

随着 VS Code 的日益普及，我们有幸和机会与越来越多具有不同开发环境的用户交谈，许多用户的环境与我们自己的环境截然不同，以便尝试找出我们可以推动 VS Code 前进以解决开发人员实际痛点的方法。

在这些对话中出现了一种有趣的模式。我们看到许多开发人员试图使用 VS Code 来针对使用特定开发和运行时堆栈配置的容器和远程 VM 进行开发，仅仅是因为设置这些本地开发环境太难、太具破坏性，在某些情况下甚至是不可能的。

我们都经历过这个问题。除非我们觉得是时候“夷平”那台机器了:)，否则我们会犹豫是否要尝试像 Rust、Go、Node 或 Python3 这样的新堆栈，因为担心“搞砸”我们当前已经调整好的环境。

Python 开发人员想要切换到 VS Code，但他们不能，因为他们需要使用容器和虚拟机作为为特定 Python 堆栈配置的开发环境。

由于代码库非常庞大，我们看到像 Facebook（和 Microsoft！）这样的公司的工程师使用像 vim 这样的编辑器远程处理安全且强大的“开发人员 VM”，使用替代的基于云的搜索和导航服务，这些服务可以扩展到甚至最好的笔记本电脑都无法处理的程度。

构建和训练数据模型的数据科学家通常需要大量的存储和计算服务来分析大型数据集，这些数据集甚至无法在强大的台式机上存储或处理。

适用于 Linux 的 Windows 子系统 (WSL)的普及部分原因是它可以轻松设置包含目标操作系统的受控开发环境。实际上，VS Code 存储库中评论第三多的问题是在 Windows 上的 Linux 发行版的 Bash 终端中支持运行 code。

当前解决方案的挑战

在这些对话中，我们还不断听到开发人员在这种类型的开发中面临的相同挑战。

• 远程桌面可以使用，但是在某些 Linux 发行版上难以或不可能设置，而且开发体验可能会“滞后”。

• SSH 和 Vim（或具有文件同步功能的本地工具）可以使用，但它们速度慢、容易出错，并且通常缺乏现代开发工具的生产力。

• 基于浏览器的工具在各种情况下都很有用，但是开发人员不想放弃桌面工具提供的丰富性和熟悉度，也不想放弃他们现有的本地安装的工具链。

更糟糕的是（我们认为！）开发人员不得不牺牲诸如 IntelliSense（代码补全）、代码检查和调试之类的核心 VS Code 体验，以便针对这些环境工作。

一种不同的方法

在听到这些挑战之后，我们开始研究 WSL 支持，它看起来很简单。安装 VS Code 并（当时要小心！）像往常一样编辑 Windows 文件系统。我们确实努力为 Node.js 启用远程调试，我们认为我们可以简单地安装一个小脚本来启用从 bash shell 启动 code。

但是，这并不正确。像我们为 Node.js 调试所做的那样，为每个运行时做特殊的工作是没有意义的。如果您的 Windows 上安装了 Python 2.7 和 Flask（或根本没有安装！），而在 Linux 发行版中安装了 Python 3.7 和 Django，那么您将无法获得正确的代码补全或代码检查，因为 VS Code 正在查看 Windows 版本的任何内容。不得不在 Windows 和 Linux 上重复开发环境会使拥有 WSL 的目的落空。

我们相信我们需要一种可以同时在两个地方运行 VS Code 的方法，即在本地运行开发人员工具，并连接到在物理或虚拟机（例如，容器或 VM）的上下文中远程运行的一组开发服务。这使您在远程环境的上下文中获得丰富的本地开发体验。

介绍 VS Code 远程扩展

在过去的几个月中，我们一直在努力重新建立代码层之间的适当边界，并消除有关本地开发环境的假设。我们构建了三个新的扩展，用于与在 WSL、Docker 容器或通过 SSH 在物理和虚拟机中运行的远程工作区一起使用。

WSL 扩展允许您直接从 VS Code 使用适用于 Linux 的 Windows 子系统 (WSL)作为完整的开发环境。这种新的优化支持使您能够

• 使用 Windows 在基于 Linux 的环境中进行开发，使用特定于平台的工具链和实用程序。
• 编辑位于 WSL 或已挂载的 Windows 文件系统中的文件（例如 /mnt/c）。
• 在 Windows 上运行和调试基于 Linux 的应用程序。

命令和扩展直接在 Linux 发行版中运行，因此您不必担心路径问题、二进制兼容性或其他跨操作系统挑战。您可以在 WSL 中像在 Windows 中一样使用 VS Code。

观看这个 2 分钟的快速视频，了解在 WSL 中进行开发有多么容易。

有关更多信息，请参阅在 WSL 中开发文档。

Remote - SSH 扩展允许您打开任何具有正在运行的 SSH 服务器的远程计算机、VM 或容器上托管的文件夹或工作区。通过 SSH 进行开发使您能够

• 在比本地计算机更大、更快或更专业的硬件上进行开发。
• 在不同的远程开发环境之间快速切换，并安全地进行更新，而无需担心会影响本地计算机。
• 调试在其他地方运行的应用程序，例如客户站点或云中。

例如，假设您正在处理一个深度学习项目。您通常需要一个配置了训练大规模数据集模型所需的所有工具和框架的 GPU 密集型虚拟机（例如 Azure 数据科学虚拟机）。

您可以使用 Vim over SSH 或 Jupyter Notebooks 来编辑您的远程代码，但是您放弃了本地开发工具的丰富性。相反，使用 Remote - SSH 扩展，您可以简单地连接到 VM，安装必要的扩展，例如Python，然后您可以利用 VS Code 的所有强大功能，例如 IntelliSense（代码补全）、代码导航和调试，就像您在本地工作一样。

观看这个 2 分钟的快速视频，了解通过 SSH 在虚拟机上进行开发有多么容易。

有关更多信息，请参阅使用 SSH 进行开发文档。

开发容器扩展允许您使用 Docker 容器作为您的开发容器。容器是很好的开发环境，因为

• 您可以使用一致且易于重现的工具链，在与您部署到的操作系统相同的操作系统上进行开发。
• 容器是隔离的，这意味着您可以在不同的开发环境之间快速切换，而不会影响本地计算机。
• 其他人可以轻松地为您的项目做出贡献，因为他们可以轻松地在一致的开发环境中进行开发、构建和测试。

可以使用 devcontainer.json 文件来告诉 VS Code 如何配置开发容器，包括要使用的 Dockerfile、要打开的端口以及要在容器中安装的扩展。当 VS Code 在工作区中找到 devcontainer.json 时，它会自动构建（如果需要）镜像，启动容器并连接到它。您的文件会挂载到容器中，因此您可以打开文件并开始使用完整的 IntelliSense（代码补全）、代码导航、调试等功能进行编辑。

观看这个 2 分钟的快速视频，了解开发容器的实际应用。

有关开发容器的更多信息，请参阅在容器内开发文档，以及包含您可以立即使用的示例的 vscode-remote-try-* 存储库。

管理扩展

远程开发时，VS Code 将尝试根据扩展公开的功能来推断将扩展安装在本地还是远程位置。扩展分为以下两个类别之一

• UI 扩展是本地安装的。这些扩展仅自定义 UI，不会访问工作区中的文件，这意味着它们完全可以在本地计算机上运行。由于它们是本地安装的，因此无论您在哪个工作区中工作，它们始终可用。UI 扩展的示例包括主题、代码片段、语言语法和键盘映射。

• 工作区扩展是远程安装的。它们访问工作区中的文件和文件夹进行编辑，以提供 IntelliSense（补全）、转到定义、调试等功能。这些扩展可能会自定义 UI。这些扩展在远程运行，以便它们可以完全访问远程主机上的文件系统和工具。

大多数扩展程序已经更新，可以在远程环境中正常工作，但是如果您遇到某些不能正常工作的扩展程序，请在扩展程序上提交问题。

扩展作者

如果您正在创建 VS Code 扩展，我们已经实现了新的扩展 API，这些 API 是远程感知的。例如，扩展作者应该使用 vscode.env.openExternal API 来加载浏览器窗口，而不是使用 open 包，这将会在本地打开浏览器。类似地，有一个新的 clipboard 类，它将按照预期将内容放置在本地剪贴板上。

更多详细信息可以在更新的 API 文档中找到，包括如何在远程环境中运行、测试和调试您的扩展。

开始使用

感谢您阅读到这里！

以下是开始进行 Visual Studio Code 远程开发的 3 个快速步骤

1. 安装 Insiders 版本。在稳定版中提供远程开发功能之前，您需要使用此版本进行远程开发。Insiders 版本每天都会发布最新的功能和错误修复。如果您担心稳定性，请不要担心！我们使用 Insiders 版本来开发 VS Code，并且它可以与稳定版并排安装，以防出现任何问题（并告知我们）。

2. 获取 远程开发扩展包，它安装对 WSL、SSH 和容器的支持，这是开始使用的最简单方法。如果您不需要所有这些，则可以卸载各个扩展。

3. 阅读 文档。尝试 Dev 容器示例。如果您使用 Python 进行开发（你们中的很多人都是！），请查看 Dan Taylor 关于远程 Python 开发的博客文章。

最后，如果您遇到问题，请提交问题。有关常见问题的答案，请参阅我们的 FAQ。

请告诉我们您的想法！

编码愉快，

@code 团队