Skip to main content

将拉取请求与合并队列合并

在 GitHub 中使用合并队列,简化拉取请求的合并流程,确保必要检查通过,并有效管理队列操作。

谁可以使用此功能?

拉取请求合并队列在组织拥有的任何公共存储库中均处于可用状态,或在使用 GitHub Enterprise Cloud 的组织拥有的专用存储库中处于可用状态。 请参阅“GitHub的计划”。

Tool navigation

关于合并队列

合并队列有助于在经过所需的检查后将拉取请求合并到繁忙的受保护分支中。 请参阅“管理合并队列”。

将拉取请求添加到合并队列

注意

您可以使用 GitHub CLI 将拉取请求添加到合并队列中。 有关详细信息,请单击本文顶部的“GitHub CLI”选项卡。

  1. 在 GitHub 上,导航到存储库的主页面。

  2. 在仓库名称下,单击 “Pull requests”****。

    存储库的主页的屏幕截图。 在水平导航栏中,标记为“拉取请求”的选项卡以深橙色标出。

  3. 在“拉取请求”列表中,单击要添加到合并队列的拉取请求。

  4. 单击“准备就绪后合并”,将拉取请求添加到合并队列。 或者,如果你是管理员,可以执行以下操作:

    • 如果分支保护设置允许,通过选中合并而不等待满足要求(绕过分支保护) 直接合并拉取请求,并遵循标准流程。

    拉取请求的合并队列选项的屏幕截图。

    注意

    您可以在所有要求都通过之前单击准备就绪时合并。 GitHub 满足要求时,将拉取请求添加到队列。

  5. 单击“准备就绪后确认合并”****,确认你要将拉取请求添加到合并队列。

使用 GitHub CLI 时,请使用 gh pr merge 命令将拉取请求添加到合并队列中。 如果您指定的目标是一个需要合并队列的分支,并且所需的检查已通过,此命令将会自动地将拉取请求添加到队列中。 如果需要的检查尚未通过,此命令将启用拉取请求的自动合并。 请参阅gh pr merge手册中的

从合并队列中删除拉取请求

若要从合并队列中删除拉取请求,必须导航到存储库的页面 GitHub.com。 不能使用 GitHub CLI 将拉取请求从合并队列中移除。

  1. 在 GitHub 上,导航到存储库的主页面。

  2. 在仓库名称下,单击 “Pull requests”****。

    存储库的主页的屏幕截图。 在水平导航栏中,标记为“拉取请求”的选项卡以深橙色标出。

  3. 在“拉取请求”列表中,单击要从合并队列中删除的拉取请求。

  4. 若要从队列中删除拉取请求,请单击“从队列中删除”。

    拉取请求底部的合并队列消息的屏幕截图。 “从队列中移除”按钮以深橙色轮廓显示。

或者,可以导航到基础分支的合并队列页,单击要删除的拉取请求旁边的“...”,然后选择“从队列中删除” 。 有关如何访问基本分支的合并队列页的信息,请参阅下面的部分。

查看合并队列

您可以在 GitHub 的多个位置查看基础分支的合并队列。 您无法使用 GitHub CLI 查看合并队列。

你可以在 GitHub 的多个位置查看基分支的合并队列。

  • 在存储库的“分支”页上。 如果你没有拉取请求或不知道队列中已有拉取请求,并且想要查看队列中的内容,我们建议你使用此路径。 请参阅“查看仓库中的分支”。

    存储库的“分支”页的屏幕截图。 标记为“等待合并的33个拉取请求”的链接以深橙色轮廓显示。

  • 在需要合并队列进行合并时,在拉取请求页上,滚动到时间线底部并单击合并队列链接。

    拉取请求底部的合并队列消息的屏幕截图。 “合并队列”链接以深橙色轮廓显示。

  • 合并队列视图显示当前在队列中的拉取请求,并清楚地标记了您的拉取请求。

    存储库合并队列的屏幕截图。

了解从合并队列中删除拉取请求的原因

如果请求不再满足合并要求,或者队列检查失败,则可以从合并队列中删除拉取请求。

从合并队列中删除拉取请求的原因有很多:

  • 配置的 CI 服务报告合并组的测试失败
  • 根据配置的超时设置,等待成功 CI 结果超时
  • 用户通过 API 或合并队列接口请求删除
  • 无法自动解决的分支保护失败