在 GitHub 中创建拉取请求

更新或添加内容后,便可创建拉取请求 (PR)。 发布更改需执行此步骤。 有关 PR 的更多背景信息,请参阅 Git 和 GitHub 基础知识

先决条件

打开 PR

  1. 在浏览器中,导航到 GitHub。

  2. 在右上角选择配置文件,然后选择存储库

  3. 查找刚刚在其中进行更改的存储库。 如果有多个存储库,请选择 MicrosoftDocs 上游存储库的对应存储库(例如 MicrosoftDocs/azure-docs)。

  4. 在页面顶部选择拉取请求选项卡。

  5. 如果看到绿色的比较并拉取请求按钮,则请选择该按钮。

Screenshot of the compare and pull request button in GitHub.

  1. 如果未看到该按钮,请手动打开新的 PR:

    1. 选择绿色的新建拉取请求按钮。
    2. 在“比较更改”页面上,请务必将头部存储库: 下拉列表设为你的分支(例如,your-github-id/azure-docs)。
    3. 比较: 下拉列表更改为工作分支。
    4. 查看显示的更改。 如果未看到更改,则请务必比较正确的分支。
  2. 打开拉取请求页面上,确保:

    • 基本存储库: 会与上游存储库匹配(例如,MicrosoftDocs/azure-docs)。
    • 基础: 分支会设为上游存储库中的默认分支(很可能名为 main)。 所有更改都将合并到上游分支。
    • 已更改的提交数和文件数均符合预期。

Screenshot of the Comparing changes screen in GitHub.

  1. 分支上的第一个提交消息将变为默认 PR 标题。 如果需要,请编辑此标题以使其更适合 PR(例如:更新先决条件列表)。

  2. 添加可选说明。 说明有助于查看者了解 PR 的目的。 例如,可描述尝试解决的问题或进行更改的原因。

  3. 选择创建拉取请求。 新的 PR 会链接到分支中的工作分支。 在合并此 PR 之前,推送到分支中同一工作分支的所有新提交均会自动包含在此 PR 中。

后续步骤

现已创建 PR,但尚未将其提交。 现在,便可处理拉取请求以确保对其进行查看并合并到默认分支中。