github.dev 基于 web 的编辑器

你可以使用基于 Web 的 github.dev 编辑器编辑文件和提交更改。

在本文中

注意

github.dev 编辑器目前处于 公开预览 阶段。 你可以在我们的讨论中提供反馈。

关于 github.dev 编辑器

github.dev 编辑器提供了完全在浏览器中运行的简洁的编辑体验。 使用 github.dev 编辑器，可以从 GitHub 中导航文件和源代码存储库，并创建和提交代码更改。 你可以在编辑器中打开任何存储库、复刻或拉取请求。

github.dev 编辑器在 GitHub.com 上免费供所有人使用。

github.dev 编辑器具有 Visual Studio Code 的诸多优点，如搜索、语法突出显示和源代码管理视图。 还可以使用 Settings Sync 与编辑器共享自己的 VS Code 设置。 请参阅 VS Code 文档中的设置同步。

github.dev 编辑器完全在浏览器的沙盒中运行。 编辑器不会克隆存储库，而是使用 GitHub 存储库扩展来执行将使用的大多数功能。 您的工作将保存在浏览器的本地存储中，直到您提交为止。 您应定期提交更改，以确保它们始终可访问。

必须登录到 GitHub 才能使用 github.dev 编辑器。

打开 github.dev 编辑器

可以通过以下任一方式打开 GitHub 中的任何 github.dev 存储库：

  • 要在同一浏览器标签页中打开存储库，请按 . （在 GitHub 上浏览任何存储库或拉取请求时）。

    要在新的浏览器标签页中打开存储库，请按 >。

  • 将 URL 从“github.com”更改为“github.dev”。

  • 查看文件时，选择“”下拉菜单，然后单击“github.dev”。

    编辑图标的下拉菜单的屏幕截图。 “github.dev”选项以深橙色边框突出显示。

Codespaces 和 github.dev

github.dev 和 GitHub Codespaces 都允许你直接从存储库中编辑代码。 但两者的优点略有不同，具体取决于您的使用情况。

github.devGitHub Codespaces
成本免费。个人帐户每月免费使用配额，请参阅 GitHub Codespaces 计费。
可用性可供 GitHub.com 上的所有人使用。可供 GitHub.com 上的所有人使用。
启动github.dev 在按下按键时可立即打开，可以立即开始使用它，而无需等待其他配置或安装。创建或恢复 codespace 时，将为该 codespace 分配一个 VM，并根据 devcontainer.json 文件的内容配置容器。 此设置可能需要几分钟才能创建环境。 请参阅“为代码库创建代码空间”。
计算没有关联的计算，因此您将无法创建和运行代码或使用集成终端。借助 GitHub Codespaces，可以获得专用 VM 的强大功能，在该 VM 上可以运行和调试应用程序。
终端访问无。默认情况下，GitHub Codespaces 提供一组通用工具，这意味着可以像在本地环境中一样使用终端。
扩展只有可以在 Web 中运行的扩展子集才会显示在扩展视图中，并且可以安装。 请参阅使用扩展。借助 GitHub Codespaces，您可以使用 Visual Studio Code Marketplace 中的大多数扩展。

继续使用 Codespaces

您可以在 github.dev 中启动您的工作流，然后继续在代码空间中进行工作。 如果尝试访问运行和调试视图或终端，系统将通知你它们在 github.dev 中不可用。

要在代码空间中继续工作，请单击“继续工作” 并选择“创建新代码空间”**** 在当前分支上创建代码空间。 在选择此选项之前，必须提交任何更改。

Screenshot of the "Run and Debug" side bar with a message saying that this feature is not available, and a "Continue Working On" button.

使用源控制

使用 github.dev 时，所有操作都通过“源代码管理”视图进行管理，该视图位于左侧的活动栏中。 有关“源代码管理”视图的详细信息，请参阅 VS Code 文档中的版本控制。

由于 github.dev 使用 GitHub 存储库扩展为其功能提供支持，因此无需存储更改即可切换分支。 请参阅 VS Code 文档中的GitHub 存储库。

创建新分支

  1. 如果当前分支未显示在状态栏中，请在 codespace 的底部右键单击状态栏，然后选择“源代码管理”。

  2. 单击状态栏中的分支名称。

    VS Code 状态栏中显示的分支名称的屏幕截图。

  3. 在下拉菜单中，单击要切换到的分支或输入新分支的名称，然后单击“创建新分支”。

    用于在 VS Code 中创建新分支的下拉列表的屏幕截图。 你在旧分支中所做的任何未提交的更改都将在新分支上可用。

提交更改

  1. 在活动栏中，单击“源代码管理”视图。

    VS Code 活动栏的屏幕截图，其中标有分支图标的“源代码管理”按钮以橙色边框突出显示。

  2. 若要暂存更改，请单击已更改文件旁边的按钮 ，如果你更改了多个文件并希望全部暂存，请单击“更改”旁边的按钮。

    “源代码管理”边栏的屏幕截图，其中位于“更改”右侧的暂存按钮（加号）以深橙色边框突出显示。

  3. 在文本框中，键入提交消息，描述你所做的更改。

    “源代码管理”边栏的屏幕截图，其中提交消息输入到“提交”按钮上方的文本框中。

  4. 单击“提交并推送”。****

    更改将自动推送到 GitHub 上的分支。

创建拉取请求

  1. 将更改提交到存储库的本地副本后，单击“源代码管理”边栏顶部的拉取请求图标。

    “源代码管理”边栏顶部的屏幕截图。 拉取请求图标以深橙色边框突出显示。

  2. 检查作为合并来源的本地分支和仓库以及作为合并目标的远程分支和仓库是否正确。 然后为拉取请求提供标题和描述。

    “GitHub 拉取请求”边栏的屏幕截图，其中包含用于创建拉取请求的表单，包括“标题”和“说明”字段。

  3. 单击“创建”。

使用现有的拉取请求

可以使用 github.dev 来处理现有拉取请求。

  1. 浏览到要在 github.dev 中打开的拉取请求。
  2. 按下