文档投稿人指南

针对主要更改的 GitHub 参与工作流

最近更新： 2026年3月11日

概述

此工作流适合需要做出主要更改或将经常向存储库投稿的参与者。 经常投稿的参与者通常会不断（持续时间长）做出更改，这些更改将经历多个周期（构建/验证/分段）或在签发和合并拉取请求之前跨越多日。

术语

在开始之前，我们先看看此工作流中所使用的 Git/GitHub 术语。

名称
描述
分支存储库
在指主 GitHub 存储库的副本时，通常用作名词。 实际上，分支存储库只是另一个存储库。 但从 GitHub 维护主/父存储库的双向连接的意义上来讲，这个词具有特殊意义。 有时它也用作动词，例如“必须先创建分支存储库”。
远程存储库
用于远程存储库的命名连接，例如“原始”或“上游”远程存储库。 Git 将它们称为远程存储库，因为它们用于引用其他计算机上托管的存储库。 在此工作流中，远程存储库始终表示 GitHub 存储库。
原始存储库
分配给本地存储库与其克隆存储库之间关系的名称。 在此工作流中，原始存储库表示与您的分支存储库的关系。 它有时被用作原始存储库本身的名字对象，如“记住将更改推送到原始存储库”。
上游存储库
与原始远程一样，上游存储库是与另一个存储库的命名关系。 在此工作流中，上游存储库代表本地存储库与从中创建分支存储库的主存储库之间的关系。 有时，它被用作上游存储库本身的名字对象，例如“记住从上游存储库中提取更改”。

如果您不熟悉 Git 和 GitHub 概念（如存储库或分支），请先查看 Git 和 GitHub 基础知识。

工作流

IMPORTANT
如果还没有工作流，则必须完成设置部分中的步骤。

在此工作流中，更改重复循环流入。 从您设备的本地存储库开始，它们将流回您的 GitHub 分支存储库，进入主 GitHub 存储库，并在您合并其他参与者所做的更改时再次从本地返回。

使用 GitHub 流

从 Git 和 GitHub 基础知识回想 Git 存储库包含一个主分支，外加尚未集成到主分支中的任何其他正在运行的分支。 每当您想引入一组逻辑上相关的更改时，最佳实践是创建​ 工作分支 ​以通过工作流管理您所做的更改。 我们在此将它称为工作分支是因为直到可将更改集成回主分支中为止，它都是一个用于迭代/细化更改的工作区。

通过隔离特定分支的相关更改，您可以单独控制和引入这些更改，将这些更改定位到发布周期中的特定发布时间。 实际上，根据您所从事的工作类型，您可以轻松地在存储库中使用多个工作分支。 在同一时间使用多个分支并不罕见，各个分支代表各个不同的项目。

NOTE
在主分支中作出更改​不是最佳实践。 假设您使用主分支为定时功能发布引入一组更改。 您已完成更改并正等待发布它们。 在此期间，您收到需要修复某些东西的紧急请求，于是您对主分支中的文件作出更改，然后再发布更改。 在此示例中，您既无意中发布了修复​*，又发布了*​您原本计划在特定日期发布的更改。

接下来，在本地存储库中创建一个新的工作分支，以获取您提议的更改。 每个 git 客户端各不相同，因此请咨询首选客户端的帮助。 您可以在 GitHub 流的 GitHub 指南中查看该过程的概述。

拉取请求处理

您可以提交建议的更改，方法是通过将它们捆绑在添加到目标存储库的 PR 队列的新拉取请求 (PR) 中。 拉取请求会启用 GitHub 的协作模型，方法是请求将工作分支的更改拉入并合并到另一个分支。 在大多数情况下，这另一个分支就是主存储库中的默认/主分支。

验证

在将拉取请求合并到目标分支之前，可能需要通过一个或多个 PR 验证过程。 验证过程可能会有所不同，具体取决于建议的更改范围和目标存储库的规则。 提交拉取请求后，您可以审核内容，并在适当时将其合并到主存储库中。

审核和注销

After all PR processing is completed, you should review the results (PR comments, preview URLs, etc.) to determine if additional changes to its files are required before you sign off for merging. 在 PR 审核人员审核了您的拉取请求后，如果在合并之前具有待解决的问题，他们也可以通过添加注释的方式提供反馈。

当拉取请求没有问题并签发后，系统会将您的更改合并回父分支，并且关闭拉取请求。

发布

请记住，您的拉取请求必须先由 PR 审核人员合并，然后才能将更改包含在下一个预定发布运行中。 通常，审核人员会按提交顺序审核/合并拉取请求。 如果需要先合并您的拉取请求才能将其包含在特定的发布运行中，您需要提前与 PR 审核人员展开合作，以确保在发布之前进行合并。

recommendation-more-help
contributor-help