跳至主要内容

将拉取请求链接到问题

您可以将拉取请求或分支链接到问题,以表明修复正在进行中,并在拉取请求或分支合并时自动关闭该问题。

注意

拉取请求描述中的特殊关键字在拉取请求目标存储库的默认分支时会被解释。但是,如果 PR 的基础是任何其他分支,则会忽略这些关键字,不会创建任何链接,合并 PR 不会对问题产生任何影响。**如果要使用关键字将拉取请求链接到问题,则 PR 必须位于默认分支上。**

关于链接的问题和拉取请求

您可以手动或使用拉取请求描述中支持的关键字将问题链接到拉取请求。

将拉取请求链接到其解决的问题时,协作者可以查看是否有其他人正在处理该问题。

将链接的拉取请求合并到存储库的默认分支时,其链接的问题会自动关闭。有关默认分支的更多信息,请参阅“更改默认分支”。

使用关键字将拉取请求链接到问题

您可以通过在拉取请求的描述或提交消息中使用支持的关键字将拉取请求链接到问题。拉取请求**必须**位于默认分支上。

  • 关闭
  • 关闭
  • 已关闭
  • 修复
  • 修复
  • 已修复
  • 解决
  • 解决
  • 已解决

如果使用关键字在另一个拉取请求中引用拉取请求评论,则这两个拉取请求将被链接。合并引用拉取请求也会关闭被引用的拉取请求。

关闭关键字的语法取决于问题是否与拉取请求位于同一个存储库中。

链接的问题语法示例
同一个存储库中的问题KEYWORD #ISSUE-NUMBER关闭 #10
不同存储库中的问题KEYWORD OWNER/REPOSITORY#ISSUE-NUMBER修复 octo-org/octo-repo#100
多个问题对每个问题使用完整语法解决 #10,解决 #123,解决 octo-org/octo-repo#100

只有手动关联的拉取请求才能手动取消关联。要取消关联使用关键词关联的问题,您必须编辑拉取请求描述以删除该关键词。

您也可以在提交消息中使用关闭关键词。当您将提交合并到默认分支时,问题将被关闭,但包含该提交的拉取请求不会被列为关联的拉取请求。

使用拉取请求侧边栏手动关联拉取请求到问题

任何拥有仓库写入权限的用户都可以从拉取请求侧边栏手动关联拉取请求到问题。

您可以手动将最多十个问题关联到每个拉取请求。问题和拉取请求必须位于同一个仓库中。

  1. 在 GitHub 上,导航到仓库的主页。

  2. 在您的仓库名称下,点击 拉取请求.

    Screenshot of the main page of a repository. In the horizontal navigation bar, a tab, labeled "Pull requests," is outlined in dark orange.

  3. 在拉取请求列表中,点击您想要关联到问题的拉取请求。

  4. 在右侧边栏中,点击**开发**。

    Screenshot of the issue sidebar. "Development" is outlined in dark orange.

  5. 点击您想要关联到拉取请求的问题。

使用问题侧边栏手动关联拉取请求或分支到问题

任何拥有仓库写入权限的用户都可以从问题侧边栏手动关联拉取请求或分支到问题。

您可以手动将最多十个问题关联到每个拉取请求。问题可以位于与关联的拉取请求或分支不同的仓库中。您的最后选择的仓库将被记住。

  1. 在 GitHub 上,导航到仓库的主页。

  2. 在您的仓库名称下,点击 问题.

    Screenshot of the main page of a repository. In the horizontal navigation bar, a tab, labeled "Issues," is outlined in dark orange.

  3. 在问题列表中,点击您想要关联拉取请求或分支的问题。

  4. 在右侧边栏中,点击**开发**。

    Screenshot of the issue sidebar. "Development" is outlined in dark orange.

  5. 点击包含您想要关联到问题的拉取请求或分支的仓库。

  6. 点击您想要关联到问题的拉取请求或分支。

  7. 点击**应用**。

进一步阅读