Skip to main content
我们经常发布文档更新,此页面的翻译可能仍在进行中。 有关最新信息,请访问英语文档

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

如果分支的分支保护设置需要合并队列,可以将拉取请求添加到合并队列中,一旦所有必需的检查通过,GitHub 将合并拉取请求。

拉取请求合并队列在组织拥有的任何公共存储库中可用,或在使用 GitHub Enterprise Cloud 的组织拥有的专用存储库中可用。 有关详细信息,请参阅“GitHub 的产品”。

注意: 拉取请求合并队列功能目前为公开测试版本,可能会发生更改。

关于合并队列

合并队列可以提升拉取请求合并到繁忙的目标分支的速度,同时确保所有必需的分支保护检查都通过。

拉取请求通过所有必需的分支保护检查后,对存储库具有写入访问权限的用户可以将该拉取请求添加到合并队列。

合并队列可以使用 GitHub Actions。 有关详细信息,请参阅“GitHub Actions文档”。 有关合并队列的信息,请参阅“管理合并队列”。

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

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

  1. 在 GitHub.com 上,导航到存储库的主页。 1. 在存储库名称下,单击 “拉取请求”。 问题和拉取请求选项卡选择

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

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

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

    提示: 只要准备好合并建议的更改,就可以单击“准备就绪后合并”。 一旦满足所需的审批和状态检查条件,GitHub 会自动将拉取请求添加到合并队列中。

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

通过 GitHub CLI,可以使用 gh pr merge 命令将拉取请求添加到合并队列。 如果面向需要合并队列的分支,则此命令会自动将拉取请求添加到队列(如果需要的检查已通过)。 如果需要的检查尚未通过,此命令将启用拉取请求的自动合并。 有关详细信息,请参阅 GitHub CLI 手册中的 gh pr merge

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

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

  1. 在 GitHub.com 上,导航到存储库的主页。 1. 在存储库名称下,单击 “拉取请求”。 问题和拉取请求选项卡选择

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

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

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

查看合并队列

可以在 GitHub 上的不同位置查看基础分支的合并队列。 不能使用 GitHub CLI 查看合并队列。

可以在 GitHub 上的不同位置查看基础分支的合并队列。

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

    在“分支”页面中查看合并队列

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

    在拉取请求上合并队列链接

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

    合并队列视图

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

在将拉取请求与目标分支的最新版本分组并在队列中提前更改后,如果所需的状态检查失败或与基本分支冲突,GitHub 将从队列中删除拉取请求。 拉取请求时间线将显示从队列中删除拉取请求的原因。