跳至主要内容

在 GitHub Desktop 中管理分支

你可以使用 GitHub Desktop 从仓库中的现有分支创建一个新分支,以便安全地尝试更改。

平台导航

关于管理分支

你可以使用分支安全地尝试对项目进行更改。分支将你的开发工作与仓库中的其他分支隔离开来。例如,你可以使用分支来开发新功能或修复错误。

你总是从现有分支创建分支。通常,你可能会从仓库的默认分支创建分支。然后,你可以在这个新分支上独立于其他人对仓库所做的更改进行工作。

你还可以从分支历史记录中的先前提交开始创建一个分支。如果你需要返回到仓库的早期视图来调查错误,或在最新版本之上创建热修复,这将很有帮助。

一旦你对自己的工作感到满意,你就可以创建一个拉取请求,将当前分支中的更改合并到另一个分支中。有关更多信息,请参阅“从 GitHub Desktop 创建问题或拉取请求”和“关于拉取请求”。

如果你对仓库有读取权限,你始终可以在 GitHub Desktop 中创建一个分支,但只有当你对仓库有写入权限时,你才能将分支推送到 GitHub。

仓库管理员可以在分支上启用保护。如果你正在处理受保护的分支,你将无法删除或强制推送到分支。仓库管理员可以启用其他受保护的分支设置,以便在合并分支之前强制执行特定的工作流。有关更多信息,请参阅“关于受保护的分支”。

仓库管理员还可以启用规则集。规则集可用于在创建新分支时要求特定的分支名称,或仅允许具有绕过权限的用户将新分支发布到远程仓库。如果分支不遵循规则集,GitHub Desktop 将显示警告并阻止创建分支。有关更多信息,请参阅“关于规则集”。

创建分支

提示:创建的第一个新分支将基于默认分支。如果您有多个分支,则可以选择将新分支基于当前检出的分支或默认分支。

  1. 在应用程序顶部,单击 当前分支,然后在分支列表中,单击您希望将新分支基于其的分支。

    Screenshot of the "Current Branch" dropdown view. Under "Recent Branches", a branch, named "my-feature", is highlighted with an orange outline.

  2. 单击新建分支

    Screenshot of the "Current Branch" dropdown view. Next to the "Filter" field, a button, labeled "New Branch", is outlined in orange.

  3. 在“创建分支”窗口中,“名称”下,键入新分支的名称。

  4. 在“基于创建分支...”下,为新分支选择一个基础分支。

  5. 单击创建分支

从以前的提交创建分支

  1. 在左侧边栏中,单击历史记录

    Screenshot of the "History" tab in the sidebar. Above a list of commits, the tab button, labeled "History", is highlighted with an orange outline.

  2. 右键单击您希望从中创建新分支的提交,然后选择从提交创建分支

    Screenshot of a list of commits in the "History" tab. Next to a commit, in a context menu, the cursor hovers over the "Create Branch from Commit" option.

  3. 在“创建分支”窗口中,“名称”下,键入新分支的名称。

  4. 单击创建分支

发布分支

如果您在 GitHub 上创建分支,则需要发布该分支,以便在 GitHub 上进行协作。

  1. 在存储库栏中,单击 当前分支,然后单击您希望发布的分支。
    Screenshot of the "Current Branch" dropdown view. Under "Recent Branches", a branch, named "my-feature", is highlighted with an orange outline.
  2. 单击发布分支
    Screenshot of the repository bar. On the right-hand side, a button, labeled "Publish branch", is highlighted with an orange outline.

在分支之间切换

您可以查看和提交存储库的任何分支。如果您有未提交的已保存更改,则在切换分支之前,您需要决定如何处理您的更改。您可以在当前分支上提交您的更改,将您的更改暂存以暂时将它们保存在当前分支上,或将更改带到您的新分支上。如果您希望在切换分支之前提交您的更改,请参阅“在 GitHub Desktop 中提交和查看项目更改”。

提示:您可以在提示设置中设置切换分支的默认行为。有关更多信息,请参阅“在 GitHub Desktop 中配置基本设置”。

  1. 在存储库栏中,单击 当前分支,然后单击您希望切换到的分支。
    Screenshot of the "Current Branch" dropdown view. Under "Recent Branches", a branch, named "my-feature", is highlighted with an orange outline.
  2. 如果您有已保存的未提交更改,则在“切换分支”窗口中,选择将我的更改保留在 CURRENT-BRANCH 上将我的更改带到 NEW-BRANCH 上,然后单击切换分支

删除分支

如果分支当前与开放的拉取请求关联,则无法删除该分支。删除分支后无法撤消。

  1. 在存储库栏中,单击 当前分支,然后单击要删除的分支。
    Screenshot of the "Current Branch" dropdown view. Under "Recent Branches", a branch, named "my-feature", is highlighted with an orange outline.
  2. 在菜单栏中,单击分支,然后单击删除...。您还可以按 Shift+Command+D
    Screenshot of the menu bar on a Mac. In the expanded "Branch" dropdown menu, the cursor hovers over the "Delete" option, highlighted in blue.
  1. 在存储库栏中,单击 当前分支,然后单击要删除的分支。
    Screenshot of the "Current Branch" dropdown view. Under "Recent Branches", a branch, named "my-feature", is highlighted with an orange outline.
  2. 在菜单栏中,单击分支,然后单击删除...。您还可以按 Ctrl+Shift+D
    Screenshot of the "GitHub Desktop" menu bar on Windows. In the expanded "Branch" dropdown menu, an option labeled "Delete" is outlined in orange.

延伸阅读