在 VS Code 中试试

远程仓库

2021 年 6 月 10 日,作者:Brigit Murtaugh, @BrigitMurtaugh, Eric Amodio, @eamodio

注意:自本博客文章发布以来,远程仓库扩展已更名为 GitHub Repositories。您还可以查看最新文档,其中包含该扩展的最新信息。

我们很高兴推出适用于 Visual Studio Code 的全新 远程仓库 扩展!这是一项我们与 GitHub 的朋友们合作构建的新体验,旨在快速安全地在 VS Code 内使用源代码仓库。

Remote Repositories extension

一种更快地打开源代码仓库的方式

在 VS Code 中,我们从一开始就提供了对 Git 的集成支持,并且通过扩展支持了许多其他源代码管理 (SCM) 提供程序。这使得开发人员能够直接在 VS Code 中克隆和使用仓库。

然而,开发人员日常工作很大一部分涉及阅读他人的代码:审查拉取请求、浏览开源仓库、试验新技术或项目、检查上游依赖项以调试应用程序等。所有这些共同点是,作为第一步,您通常会在本地克隆仓库,然后在您喜欢的代码编辑器(我们希望是 VS Code!)中打开代码。然而,克隆仓库需要时间,如果您忘记拉取,可能会导致您审查过时的仓库版本,并且如果您不熟悉代码,有时可能存在安全风险。

由 GitHub 发布的全新 远程仓库 扩展,让在 VS Code 中打开源代码仓库变得即时且安全。有了它,您可以直接在 VS Code 内快速浏览、搜索、编辑和提交到任何远程 GitHub 仓库(很快也将支持 Azure Repos),无需克隆!

您可以根据需要使用任意数量的仓库,而无需在本地计算机上保存任何源代码。远程仓库为您节省时间和本地磁盘空间,并使您能够完全在 VS Code 中完成所有源代码控制任务。

在这篇博客文章中,我们将探讨远程仓库的上手有多么容易,打开您的第一个远程仓库后可以做什么,支持此虚拟环境的技术细节,以及您今天如何向我们提供反馈。

在 VS Code 中打开您的第一个远程仓库

让我们在 VS Code 中打开一个远程仓库。首先,请确保您已安装 远程仓库 扩展。

目前,远程仓库支持 GitHub 仓库,很快将支持 Azure Repos。在这篇博客文章中,我们将从打开 VS Code 仓库 (microsoft/vscode) 开始。

安装远程仓库扩展后,点击 VS Code 左下角的远程指示器(以及您已安装的任何其他远程开发扩展的命令),我们可以立即访问其 打开远程仓库 命令。

Remote indicator in VS Code

如果您之前未从 VS Code 登录 GitHub,系统将提示您验证您的 GitHub 帐户。登录后,搜索仓库或 PR,选择您想要的那个,即可开始使用。

在下面的短视频中,我们搜索并选择了 VS Code 仓库,VS Code 重新加载,然后仓库内容像我们在本地克隆一样加载。

Gif of using Open Remote Repository command, search for "microsoft/vscode," repo loads, open readme

您无需离开 VS Code 即可探索和贡献到仓库。您会感觉像在本地代码上工作一样,使用熟悉的 VS Code 界面,并且可以使用 VS Code 资源管理器、搜索、时间线视图、快速打开以及源代码管理等功能。

您现在连接到一个称为虚拟工作区(有关虚拟工作区的更多信息请参阅下文)的环境;远程指示器显示“GitHub”。当您将鼠标悬停在远程指示器上时,会通知您在虚拟工作区中某些功能不可用。

Hover over remote indicator for limited virtual workspace message

虚拟工作区是一种特殊设置,某些功能(如扩展)会被禁用或功能受限。您可以通过点击远程指示器悬停时显示的某些功能链接,轻松找出哪些扩展被禁用。

点击链接会显示哪些扩展被禁用,哪些功能受限。将鼠标悬停在扩展上时可以看到功能受限的情况。

VS Code Extensions view with limited and disabled extensions

如果您想在虚拟工作区中手动启用扩展,可以在用户 settings.json 文件中使用 extensions.supportVirtualWorkspaces 设置。

    "extensions.supportVirtualWorkspaces": { "<extensionID>": true }

请记住,扩展可能未实现处理没有本地文件系统访问权限的虚拟工作区,因此扩展可能无法按预期工作。

您打开了一个仓库,接下来呢?

通过打开您的仓库,远程仓库使贡献到您的项目变得容易。

简化的 Git 工作流,使您的项目保持最新

远程仓库每次都能帮助您保持仓库最新版本,无需任何复杂的 Git 命令。

每当您打开新仓库时,您都会打开最新版本。每当远程仓库检测到 GitHub 有新更改时,它会在状态栏中列出您需要拉取的提交数量。

VS Code Status bar showing "GitHub" in remote indicator and 1 pending change

并在资源管理器中突出显示已修改的文件

VS Code Explorer listing files and README has 1 change

当您提交更改时,它们将自动显示在 GitHub 上——您无需推送更改或发布您创建的任何新分支。

创建或检出拉取请求

远程仓库与 GitHub Pull Requests and Issues 扩展 配合良好,该扩展允许您直接在 VS Code 中审查和管理 GitHub 的拉取请求和问题。并行使用这两个扩展,可以快速检出 PR 并处理问题,而无需在本地克隆代码或离开 VS Code。

您可以更改代码,根据该更改创建新分支和拉取请求 (PR),然后检出 PR,所有这些都只需点击几下。

Gif using GitHub Pull Request extension to create branch and PR, and check out that PR

您可以在我们的使用 GitHub 文章中了解更多关于 GitHub Pull Requests and Issues 扩展的信息。

将更改隔离到分支

在完成工作时,您可能需要在分支之间切换。在典型环境中,当您需要决定要暂存或提交哪些更改时,这可能会变得棘手。

远程仓库允许您轻松地同时处理不同的分支。当您暂停一个分支上的工作并切换到新分支时,不会询问您是否暂存更改——它们将自动保留在先前分支上。当您返回到先前分支时,您的更改仍将存在,您可以从上次中断的地方继续。

让我们探讨如何将更改推送到分支。

在状态栏中,选择当前分支以打开分支列表,例如“main”。

VS Code Status bar on Main branch

选择 + 创建新分支... 并输入您的分支名称。

VS Code Command Palette with options to create new branch

然后您可以切换到该新分支。

Remote Repositories prompt to switch to new branch

新分支将不包含来自您先前分支的任何更改。

限制

使用远程仓库时存在某些限制。

  • 调试、终端和任务 - 当前不支持。终端在您的本地文件系统上打开,并且无法访问远程仓库的虚拟文件系统。
  • 有限的语言智能 - IntelliSense 和转到定义等功能可能会受到影响,因为许多语言尚不理解远程仓库的虚拟化环境。
  • 搜索 - GitHub 搜索本身有局限性,例如不索引分支。远程仓库可以通过启用索引来避免此限制并执行全文搜索。索引从 GitHub 拉取仓库的浅层克隆,并在本地执行全面搜索,提供比 GitHub 模糊的默认分支原生搜索更强大的功能。您可以在搜索视图中启用远程仓库的索引。
  • 扩展限制 - 并非所有扩展都支持在虚拟工作区中运行,但随着时间的推移,更多扩展将支持它。严重依赖本地文件访问的扩展无法支持此设置。有关更多详细信息,请参阅下面的虚拟工作区部分。

我们才刚刚踏上这段旅程,因此随着我们继续开发,功能集会增加,限制也会减少。

在更强大的环境中继续工作

使用远程仓库时,VS Code 在一个并非所有功能都可用的环境中运行,因为没有物理文件系统。这对于快速开始浏览仓库非常有用,但是当您准备进行一些更“高级”的工作时,例如:

  • 您想积极地处理仓库并获得 VS Code 的全部功能。
  • 您需要通过定期从远程拉取来积极跟踪仓库的更改。

为了转向更高级的工作流,远程仓库提供了一种“升级”您的环境并继续在那里工作的方式,从您当前所在的位置继续。

点击左下角的远程指示器,然后选择继续工作...

VS Code Command Palette with "Continue Working on..." command

您将看到三个选项

  • 在本地克隆仓库:将当前仓库克隆到您的本地机器。将弹出一个本地文件浏览器,允许您选择磁盘上的位置来克隆远程仓库。
  • 在容器卷中克隆仓库:使用开发容器扩展在 Docker 容器卷 中克隆当前仓库(您需要安装 开发容器 扩展和 Docker)。VS Code 将重新加载并使用开发容器连接,远程指示器现在将显示 Dev Container: {image name}
  • 在 Codespaces 中打开:在 GitHub Codespace 中继续您的工作。当您选择此选项时,浏览器将打开并引导您到此仓库的 Codespaces 列表。

VS Code Command Palette with options to continue locally, in a volume, or in Codespaces

现在我们已经探讨了如何在 VS Code 中使用远程仓库,接下来我们将介绍支持该体验的一些技术细节,以及如何确保您的扩展在远程仓库会话中正常工作。

虚拟文件系统和工作区

驱动这项远程工作的核心概念是虚拟文件系统和虚拟工作区。

作为最终用户,您只需要知道要使用哪个仓库或 PR——VS Code 会为您处理虚拟文件系统和管理您的工作区。作为扩展开发人员,您需要采用虚拟文件系统 API 来确保您的扩展行为符合预期。

虚拟文件系统的工作原理

当您在传统的 Git 工作流中工作时,您会“git clone”一个仓库,副本会保存到您计算机的本地文件系统。但当使用远程仓库时,代码并不在您的本地计算机上;它仍然只在 GitHub 上。

您通过虚拟文件系统处理代码,这是一个抽象,它将物理存在于磁盘上的文件进行抽象。虚拟文件系统可以从 GitHub 等代码托管平台、云存储或数据库提供内容,并无缝地将这些内容作为文件提供给 VS Code 中的用户。

当您在虚拟文件系统上打开工作区时,这称为虚拟工作区。在虚拟工作区中工作时,您仍然可以访问 VS Code 的功能,包括扩展。

确保您的扩展在虚拟工作区中正常工作

为了使扩展正常运行,它们必须支持虚拟文件系统。

如果扩展没有代码,只是一个纯粹的颜色主题、键绑定、片段或语法扩展,那么它可以在虚拟工作区中运行,无需进行任何适配。

运行实际代码的扩展,即定义了主入口点的扩展,需要检查并可能进行适配。

虚拟文件系统的 API 支持是通过 FileSystemProvider 接口实现的。文件系统提供程序为新的 URI 方案(例如,vscode-vfs)注册,并且该文件系统上的资源将由使用该方案的 URI(vscode-vfs://github/microsoft/vscode/package.json)表示。

扩展的 package.json 中有一个 capabilities 属性,其中的 virtualWorkspaces 子属性用于指示扩展是否与虚拟工作区一起工作。

您可以在虚拟工作区扩展作者指南中了解有关虚拟文件系统、工作区以及如何为扩展实现它们的更多信息。

反馈&进一步阅读

我们非常期待您试用远程仓库,并迫不及待地等待您的反馈。

请安装 远程仓库 扩展。您可以提交任何 问题或功能请求,或在 Twitter 上向我们发送您的想法 @code

您还可以观看我们关于如何使用远程仓库扩展的全新YouTube 视频

如果您是扩展作者,请查看扩展作者的虚拟工作区支持指南,并在我们的跟踪问题中分享任何问题或反馈。您还可以加入扩展作者社区的 Slack 群组

祝您编码愉快!

Brigit Murtaugh,VS Code 项目经理 @BrigitMurtaugh
Eric Amodio,VS Code 首席软件工程师 @eamodio