创建拉取请求

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

谁可以使用此功能？

Anyone with read access to a repository can create a pull request.

如果要为拉取请求创建新分支，又没有仓库的写入权限，可以先对仓库复刻。有关详细信息，请参阅“从复刻创建拉取请求”和“关于分叉”。

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

你可以将拉取请求链接到问题，以显示修复正在进行中，并在某人合并拉取请求时自动关闭该问题。有关详细信息，请参阅“将拉取请求链接到议题”。

默认情况下，拉取请求基于父仓库的默认分支。有关详细信息，请参阅“关于分支”。

如果默认父仓库不正确，您可以使用下拉列表更改父仓库和分支，还可以使用下拉列表交换头部分支和基本分支，以确定引用点之间的差异。这里的引用必须是 GitHub 仓库中的分支名称。

拉取请求的屏幕截图。用于编辑比较分支的下拉列表已展开。

考虑分支时，请记住，“基础分支”是应应用更改的位置，“头部分支”包含要应用的内容。

更改基本仓库时，也会更改关于拉取请求的通知。每个对基本仓库有推送权限的人都会收到电子邮件通知，他们下次登录时会在仪表板上看到新的拉取请求。

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

Tip

在 GitHub 上，导航到存储库的主页面。
在“Branch（分支）”菜单中，选择包含提交的分支。
在文件列表上方的黄色横幅中，单击“比较和拉取请求”****，为关联的分支创建拉取请求。
使用基础分支下拉菜单选择要向其合并更改的分支，然后使用比较分支下拉菜单选择进行了更改的主题分支。
为您的拉取请求输标题和说明。
要创建可供审查的拉取请求，请单击“创建拉取请求”。若要创建草稿拉取请求，请使用下拉列表并选择“创建草稿拉取请求”，然后单击“草稿拉取请求” 。如果你是组织的成员，则可能需要从组织所有者请求对草稿拉取请求的访问权限。请参阅“关于拉取请求”。

提示：创建拉取请求后，你可请求特定人员审查你提议的更改。有关详细信息，请参阅“请求拉取请求审查”。

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

若要详细了解 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 浏览器中创建拉取请求，请使用 --web 标志。

gh pr create --web

单击“预览拉取请求”。 GitHub Desktop 将打开一个预览对话框，其中显示当前分支与基础分支之间的更改差异。

或者，若要直接转到 GitHub 创建拉取请求，请选择下拉图标并单击“创建拉取请求”。
确认“基础:”下拉菜单中的分支是要合并更改的分支。

GitHub Desktop 会提示你当前分支是否可以自动合并到基础分支中。
单击“创建拉取请求”。 GitHub Desktop 会将您的默认浏览器打开至 GitHub。
为您的拉取请求输标题和说明。
要创建可供审查的拉取请求，请单击“创建拉取请求”。若要创建草稿拉取请求，请使用下拉列表并选择“创建草稿拉取请求”，然后单击“草稿拉取请求” 。如果你是组织的成员，则可能需要从组织所有者请求对草稿拉取请求的访问权限。请参阅“关于拉取请求”。