Skip to main content

创建拉取请求

创建拉取请求以建议对存储库中的代码进行更改。

谁可以使用此功能?

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

如果想要为拉取请求创建新分支,但对存储库没有写入权限,可以先分叉存储库。 请参阅 Creating a pull request from a fork叉子

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

注意

要在公共存储库中打开拉取请求,你必须具有对头分支或源分支写入权限;对于组织拥有的仓库,你必须是拥有该存储库的组织的成员才能打开拉取请求。

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

创建拉取请求

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

  2. 在“Branch(分支)”菜单中,选择包含提交的分支。

    存储库主页上分支下拉菜单的屏幕截图。

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

    文件列表上方横幅的屏幕截图。

  4. 使用 分支下拉菜单选择要合并更改的分支。 然后,使用 compare 分支下拉菜单选择你进行更改的主题分支。

  5. 为您的拉取请求输标题和说明。

  6. 要创建可供审查的拉取请求,请单击“创建拉取请求”。 若要创建草稿拉取请求,请使用下拉列表并选择“创建草稿拉取请求”,然后单击“草稿拉取请求” 。 如果你是组织的成员,则可能需要从组织所有者请求对草稿拉取请求的访问权限。 请参阅“拉取请求”。

提示

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

审查拉取请求后,可以将其合并到存储库中。 请参阅“Merging a pull request”。

注意

若要详细了解 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
  1. 单击预览拉取请求。 GitHub Desktop 打开一个预览对话框,显示当前分支和基分支之间的更改差异。

    或者,若要直接转到 GitHub 创建拉取请求,请选择下拉列表图标并单击“ 创建拉取请求”。

  2. 确认“基准:”下拉菜单中的分支是您要合并更改的分支。

    “打开拉取请求”对话框窗口的屏幕截图。 带有下拉图标(标有“基础: 开发”)的按钮以橙色框出。

GitHub Desktop 指示当前分支是否可以自动合并到基分支中。

“打开拉取请求”对话框窗口的屏幕截图。 显示“无法自动合并”的状态标签以橙色边框突出显示。

  1. 单击Create Pull Request。 GitHub Desktop 会打开你的默认浏览器并带你前往 GitHub。
  2. 为您的拉取请求输标题和说明。
  3. 要创建可供审查的拉取请求,请单击“创建拉取请求”。 若要创建草稿拉取请求,请使用下拉列表并选择“创建草稿拉取请求”,然后单击“草稿拉取请求” 。 如果你是组织的成员,则可能需要从组织所有者请求对草稿拉取请求的访问权限。 请参阅“拉取请求”。
  1. 将更改提交到存储库的本地副本后,单击“ 创建拉取请求 ”图标。

“源代码管理”边栏顶部的屏幕截图。 拉取请求图标以深橙色边框突出显示。

  1. 检查作为合并来源的本地分支和仓库以及作为合并目标的远程分支和仓库是否正确。 然后,为拉取请求提供标题和说明。

“GitHub 拉取请求”边栏的屏幕截图,其中包含用于创建拉取请求的表单,包括“标题”和“说明”字段。

  1. 单击 “创建”

有关在 GitHub Codespaces 中创建拉取请求的详细信息,请参阅 将 GitHub Codespaces 用于拉取请求

对拉取请求中的文件进行更改

打开拉取请求后,可以通过向头分支添加新提交来继续更改文件。

您还可以在 GitHub 网站上修改文件。

  1. 在 GitHub 上,转到存储库中的拉取请求。

  2. 在拉取请求上,单击“ Files changed”****。

    拉取请求的选项卡的屏幕截图。 “已更改的文件”选项卡以深橙色突出显示。

  3. 向下滚动到要更改的文件。

    • 如果拉取请求包含大量文件,可以使用筛选器来找到文件。
  4. 在要更改的文件上方,单击

该屏幕截图显示了“文件已更改”选项卡上的文件上方的选项。“显示选项”按钮以橙色矩形突出显示。

  1. 在菜单上,单击“编辑文件”****。
  2. 在编辑器中进行更改。 提交更改时,选择直接提交回当前头部分支。

延伸阅读