在代码空间中使用源控制

注意：在 JetBrains IDE 中使用 GitHub Codespaces 目前为公开 beta 版本，可能会随时发生更改。

关于 GitHub Codespaces 中的源代码管理

您可以直接在代码空间内执行所需的所有 Git 操作。例如，可以从远程存储库获取更改、切换分支、创建新分支、提交和推送更改以及创建拉取请求。您可以使用代码空间内的集成终端输入 Git 命令，也可以单击图标和菜单选项以完成所有最常见的 Git 任务。本指南解释如何使用图形用户界面来控制源代码。

有关 Visual Studio Code 中的 Git 支持的详细信息，请参阅 Visual Studio Code 文档中的“在 VS Code 中使用版本控制”。

Visual Studio Code Web 客户端中的源代码管理使用与 Visual Studio Code 桌面应用程序相同的工作流。有关详细信息，请参阅 Visual Studio Code 文档中的“在 VS Code 中使用版本控制”。

使用 GitHub Codespaces 更新文件的典型工作流程将是：

从 GitHub 上仓库的默认分支，创建代码空间。请参阅“为存储库创建 codespace”。
在代码空间中，创建一个新的分支来操作。
进行更改并保存。
提交更改。
提出拉取请求。

发布从模板创建的 Codespace

通过模板存储库或“你的 Codespace”页上的模板创建 Codespace 时，所做的工作不会存储在 GitHub 上的存储库中，直到你发布 Codespace。有关详细信息，请参阅“从模板创建 Codespace”。

如果你使用的是 codespace，可以从 VS Code Web 客户端或桌面应用程序发布它。

在活动栏中，单击“源代码管理”视图。
若要暂存更改，请单击已添加或更改文件旁边的 +，如果你更改了多个文件并希望全部暂存，请单击“更改”旁边的按钮。

注意：如果从 GitHub 的空白模板开始，则不会看到更改列表，除非已将目录初始化为 Git 存储库。若要发布从空白模板创建的 codespace，请在“源代码管理”视图中单击“发布到 GitHub”，然后跳到步骤 5。
若要提交暂存更改，请键入描述所做更改的提交消息，然后单击“提交”。
单击“发布分支”。
在“存储库名称”下拉列表中，键入新存储库的名称，然后选择“发布到 GitHub 专用存储库”或“发布到 GitHub 公共存储库”。

新存储库的所有者将是创建 codespace 时所使用的 GitHub 帐户。
（可选）在编辑器右下角显示的弹出窗口中，单击“在 GitHub 上打开”，查看 GitHub.com 上的新存储库。

创建或切换分支

如果当前分支未显示在状态栏中，请在 codespace 的底部右键单击状态栏，然后选择“源代码管理”。
单击状态栏中的分支名称。
在下拉菜单中，单击要切换到的分支或输入新分支的名称，然后单击“创建新分支”。

提示：如果有人最近在远程存储库上更改了文件，则在你切换到的分支中，只有将更改拉取到 codespace 中之后，你才能看到这些更改。

提交更改

在活动栏中，单击“源代码管理”视图。
若要暂存更改，请单击已更改文件旁边的 +，如果你更改了多个文件并希望全部暂存，请单击“更改”旁边的按钮。
输入提交消息，描述您所做的更改。
若要提交暂存更改，请单击源代码管理侧边栏顶部的复选标记。

从远程仓库拉取更改

您可以随时将远程仓库的更改拉取到您的代码空间。

在活动栏中，单击“源代码管理”视图。
在侧栏顶部，单击省略号 (…)。
在下拉菜单中，单击“拉取”。

如果自创建代码空间以来开发容器配置已更改，则可以通过为代码空间重建容器来应用更改。有关详细信息，请参阅“开发容器简介”。

设置代码空间以自动获取新更改

您可以设置代码空间，以自动获取对远程仓库所做的任何新提交的详细信息。这允许您查看仓库的本地副本是否过时，如果是，您可以选择拉取新的更改。

如果获取操作检测到远程仓库上的新更改，您将在状态栏中看到新提交的数量。然后，您可以将更改拉取到本地副本。

单击活动栏底部的“管理”按钮。
在菜单中，单击“设置”。
在设置页上，搜索：autofetch。
若要获取为当前存储库注册的所有远程更新的详细信息，请将 Git: Autofetch 设置为 all。
如果要更改自动获取的间隔秒数，请编辑 Git: Autofetch Period 的值。

提出拉取请求

提交存储库本地副本的更改后，单击“创建拉取请求”图标。
检查作为合并来源的本地分支和仓库以及作为合并目标的远程分支和仓库是否正确。然后为拉取请求提供标题和描述。
单击“创建”。

将更改推送到远程仓库

可以推送保存并提交的更改。这将应用这些更改到远程仓库上的上游分支。如果您尚未准备好创建拉取请求，或者希望在 GitHub 上创建拉取请求，则可能需要这样做。

在侧栏顶部，单击省略号 (…)。
在下拉菜单中，单击“推送”。

发布从模板创建的 Codespace

通过模板存储库或“你的 Codespace”页上的模板创建 Codespace 时，所做的工作不会存储在 GitHub 上的存储库中，直到你发布 Codespace。有关详细信息，请参阅“从模板创建 Codespace”。

如果你使用的是 codespace，可以从 VS Code Web 客户端或桌面应用程序发布它。

在活动栏中，单击“源代码管理”视图。
若要暂存更改，请单击已添加或更改文件旁边的 +，如果你更改了多个文件并希望全部暂存，请单击“更改”旁边的按钮。

注意：如果从 GitHub 的空白模板开始，则不会看到更改列表，除非已将目录初始化为 Git 存储库。若要发布从空白模板创建的 codespace，请在“源代码管理”视图中单击“发布到 GitHub”，然后跳到步骤 5。
若要提交暂存更改，请键入描述所做更改的提交消息，然后单击“提交”。
单击“发布分支”。
在“存储库名称”下拉列表中，键入新存储库的名称，然后选择“发布到 GitHub 专用存储库”或“发布到 GitHub 公共存储库”。

新存储库的所有者将是创建 codespace 时所使用的 GitHub 帐户。
（可选）在编辑器右下角显示的弹出窗口中，单击“在 GitHub 上打开”，查看 GitHub.com 上的新存储库。

创建或切换分支

如果当前分支未显示在状态栏中，请在 codespace 的底部右键单击状态栏，然后选择“源代码管理”。
单击状态栏中的分支名称。
在下拉菜单中，单击要切换到的分支或输入新分支的名称，然后单击“创建新分支”。

提示：如果有人最近在远程存储库上更改了文件，则在你切换到的分支中，只有将更改拉取到 codespace 中之后，你才能看到这些更改。

提交更改

在活动栏中，单击“源代码管理”视图。
若要暂存更改，请单击已更改文件旁边的 +，如果你更改了多个文件并希望全部暂存，请单击“更改”旁边的按钮。
输入提交消息，描述您所做的更改。
若要提交暂存更改，请单击源代码管理侧边栏顶部的复选标记。

从远程仓库拉取更改

您可以随时将远程仓库的更改拉取到您的代码空间。

在活动栏中，单击“源代码管理”视图。
在侧栏顶部，单击省略号 (…)。
在下拉菜单中，单击“拉取”。

如果自创建代码空间以来开发容器配置已更改，则可以通过为代码空间重建容器来应用更改。有关详细信息，请参阅“开发容器简介”。

设置代码空间以自动获取新更改

您可以设置代码空间，以自动获取对远程仓库所做的任何新提交的详细信息。这允许您查看仓库的本地副本是否过时，如果是，您可以选择拉取新的更改。

如果获取操作检测到远程仓库上的新更改，您将在状态栏中看到新提交的数量。然后，您可以将更改拉取到本地副本。

单击活动栏底部的“管理”按钮。
在菜单中，单击“设置”。
在设置页上，搜索：autofetch。
若要获取为当前存储库注册的所有远程更新的详细信息，请将 Git: Autofetch 设置为 all。
如果要更改自动获取的间隔秒数，请编辑 Git: Autofetch Period 的值。

提出拉取请求

提交存储库本地副本的更改后，单击“创建拉取请求”图标。
检查作为合并来源的本地分支和仓库以及作为合并目标的远程分支和仓库是否正确。然后为拉取请求提供标题和描述。
单击“创建”。

将更改推送到远程仓库

可以推送保存并提交的更改。这将应用这些更改到远程仓库上的上游分支。如果您尚未准备好创建拉取请求，或者希望在 GitHub 上创建拉取请求，则可能需要这样做。

在侧栏顶部，单击省略号 (…)。
在下拉菜单中，单击“推送”。

创建或切换分支

单击状态栏右侧的分支名称。
在弹出菜单中，执行以下操作之一：
- 要基于当前分支创建新分支，请单击当前分支的名称，然后选择“新建分支”。
  
  输入新建分支的名称并单击“创建”。
- 要签出现有分支，请开始键入要签出的分支的名称。单击列表中的分支，然后单击“签出”。
  
  提示：如果有人最近在远程存储库上更改了文件，则在你切换到的分支中，只有将更改拉取到 codespace 中之后，你才能看到这些更改。