创建拉取请求

创建拉取请求以建议和协作更改存储库。这些更改在分支中提出，确保默认分支仅包含已完成和已批准的工作。

谁可以使用此功能？

任何拥有仓库读取权限的人都可以创建拉取请求。

平台导航

本文内容

如果你想为你的拉取请求创建一个新分支，并且没有对仓库的写入权限，你可以先 fork 仓库。有关更多信息，请参阅 "从 fork 创建拉取请求" 和 "关于 fork."

你可以在创建拉取请求时指定要将更改合并到的分支。拉取请求只能在两个不同的分支之间打开。

注意：要在公共仓库中打开拉取请求，你必须对 head 分支或源分支具有写入权限，或者对于组织拥有的仓库，你必须是拥有该仓库的组织的成员才能打开拉取请求。

你可以将拉取请求链接到问题，以表明修复正在进行中，并在有人合并拉取请求时自动关闭问题。有关更多信息，请参阅 "将拉取请求链接到问题."

更改分支范围和目标仓库

默认情况下，拉取请求基于父仓库的默认分支。有关更多信息，请参阅 "关于分支."

如果默认的父仓库不正确，你可以使用下拉列表更改父仓库和分支。你也可以使用下拉列表交换 head 分支和 base 分支，以建立参考点之间的差异。此处的引用必须是 GitHub 仓库中的分支名称。

Screenshot of a pull request. The dropdown to edit the compare branch is expanded.

在考虑分支时，请记住，base 分支是更改应该应用到的位置，head 分支包含你想要应用的内容。

当你更改 base 仓库时，也会更改拉取请求的通知。所有可以向 base 仓库推送的人都会收到电子邮件通知，并在下次登录时在他们的仪表板上看到新的拉取请求。

当你更改分支范围中的任何信息时，提交和更改的文件预览区域将更新以显示你的新范围。

提示:

  • 使用比较视图，您可以设置跨任何时间范围的比较。有关更多信息，请参阅“比较提交”。
  • 项目维护者可以为存储库添加拉取请求模板。模板包括拉取请求正文中信息的提示。有关更多信息，请参阅“关于问题和拉取请求模板”。

创建拉取请求

  1. 在 GitHub.com 上，导航到存储库的主页。

  2. 在“分支”菜单中，选择包含您的提交的分支。

    Screenshot of the branch dropdown menu on the main page of a repository.

  3. 在文件列表上方，在黄色横幅中，单击**比较和拉取请求**以创建与关联分支相关的拉取请求。

    Screenshot of the banner above the list of files.

  4. 使用基础分支下拉菜单选择要将更改合并到的分支，然后使用比较分支下拉菜单选择您进行更改的主题分支。

  5. 为您的拉取请求键入标题和描述。

  6. 要创建一个准备审查的拉取请求，请单击**创建拉取请求**。要创建草稿拉取请求，请使用下拉菜单并选择**创建草稿拉取请求**，然后单击**草稿拉取请求**。有关草稿拉取请求的更多信息，请参阅“关于拉取请求”。

提示：创建拉取请求后，您可以要求特定人员审查您提出的更改。有关更多信息，请参阅“请求拉取请求审查”。

拉取请求经过审查后，可以合并到存储库中。

要了解有关 GitHub CLI 的更多信息，请参阅“关于 GitHub CLI”。

要创建拉取请求，请使用gh pr create子命令。

gh pr create

要将拉取请求分配给个人，请使用--assignee或-a标志。您可以使用@me将拉取请求分配给自己。

gh pr create --assignee "@octocat"

要指定要将拉取请求合并到的分支，请使用--base或-B标志。要指定包含拉取请求提交的分支，请使用--head或-H标志。

gh pr create --base my-base-branch --head my-changed-branch

要为新的拉取请求添加标题和正文，请使用 `--title` 和 `--body` 标志。

gh pr create --title "The bug is fixed" --body "Everything works again"

要将拉取请求标记为草稿，请使用 `--draft` 标志。

gh pr create --draft

要为新的拉取请求添加标签或里程碑，请使用 `--label` 和 `--milestone` 标志。

gh pr create --label "bug,help wanted" --milestone octocat-milestone

要将新的拉取请求添加到特定项目，请使用 `--project` 标志。

gh pr create --project octocat-project

要指定个人或团队作为审阅者，请使用 `--reviewer` 标志。

gh pr create --reviewer monalisa,hubot  --reviewer myorg/team-name

要在默认的网络浏览器中创建拉取请求，请使用 `--web` 标志。

gh pr create --web

  1. 点击 **预览拉取请求**。GitHub Desktop 将打开一个预览对话框，显示当前分支与基分支之间的更改差异。

    Screenshot of the "No local changes" view. A button, labeled "Preview Pull Request", is highlighted with an orange outline.

    Screenshot of the "No local changes" view. A button, labeled "Preview Pull Request", is highlighted with an orange outline.

    或者，要直接转到 GitHub 创建拉取请求，请选择下拉图标并点击 **创建拉取请求**。

  2. 确认 **base:** 下拉菜单中的分支是您要合并更改的分支。

    Screenshot of the "Open a Pull Request" dialog window. A button with a dropdown icon, labeled "base: development", is outlined in orange.

    GitHub Desktop 将建议您当前分支是否可以自动合并到基分支。

    Screenshot of the "Open a Pull Request" dialog window. A status label stating "Can't automatically merge" is highlighted with an orange outline.

  3. 点击 **创建拉取请求**。GitHub Desktop 将打开您的默认浏览器，带您前往 GitHub。

  4. 为您的拉取请求键入标题和描述。

  5. 要创建一个准备审查的拉取请求，请单击**创建拉取请求**。要创建草稿拉取请求，请使用下拉菜单并选择**创建草稿拉取请求**，然后单击**草稿拉取请求**。有关草稿拉取请求的更多信息，请参阅“关于拉取请求”。

  1. 在您将更改提交到本地存储库副本后，点击 **创建拉取请求** 图标。
    Screenshot of the top of the "Source Control" side bar. The pull request icon is highlighted with a dark orange outline.
  2. 检查您要从中合并的本地分支和存储库，以及您要合并到的远程分支和存储库是否正确。然后为拉取请求添加标题和描述。
    Screenshot of the "GitHub Pull Request" side bar with a form for creating a pull request, including "Title" and "Description" fields.
  3. 点击 **创建**。

有关在 GitHub Codespaces 中创建拉取请求的更多信息，请参阅 "使用 GitHub Codespaces 进行拉取请求"。

进一步阅读