一、什么是 Pull requests?
Pull Requests(PR)是代码协作平台(如 GitHub、GitLab 等)中的一种功能,用于提议将某分支的代码变更合并到另一个分支(通常是主分支)。它允许开发者在合并前进行代码审查、讨论和修改,是团队协作开发的核心工具之一。
二、提交 PR 的作用
GitHub 的 Pull Request(PR)是协作开发中的核心功能,主要用于代码审查、讨论和合并贡献。以下是其主要作用:
促进代码审查与改进
PR 允许贡献者将代码变更提交给项目维护者,维护者可以查看修改内容,提出建议或请求进一步调整。通过评论和讨论,确保代码质量符合项目标准。
简化协作流程
开源项目中,非核心成员通过 PR 提交代码变更,无需直接写入主仓库。维护者拥有最终合并权限,避免未经审核的代码影响主分支稳定性。
记录变更历史
PR 包含完整的修改描述、讨论记录和审查意见,形成可追溯的文档。合并后自动关联提交历史,便于后续排查问题或理解代码演进过程。
自动化集成检查
GitHub 可配置 CI/CD 工具(如 Actions),在 PR 阶段自动运行测试、lint 检查或构建流程。失败时会阻止合并,确保主分支始终处于可部署状态。
支持分阶段合并
大型项目可能使用多级 PR 流程,例如从开发分支提交到测试分支,再合并到主分支。不同环境对应不同审查标准,降低风险。
非代码类协作
PR 不仅限于代码,也可用于文档更新、配置文件修改等。任何仓库内容的变更均可通过此机制提交和审核。
权限管理工具
对于企业或私有项目,PR 是实施代码所有权(Code Ownership)策略的关键,特定文件修改需指定人员审批后方可合并。
通过 PR 机制,GitHub 将分布式协作流程标准化,成为现代软件开发中质量控制的核心环节。
三、提交 PR 流程
我们以国内嵌入式操作系统 RT-Thread 为例:
1、注册 GitHub 账户
首先需要注册一个自己的 GitHub 账户。
2、进入 RT-Thread 仓库
访问 RT-Thread 仓库,点击链接进入。
3、Fork 一份 RT-Thread 源码进入自己仓库
若您已 Fork,会看到如下提示;未 Fork 过的话选择自己的账户路径即可。
如果是较早之前 Fork 的仓库,可以先和上游的仓库同步一下:
4、将代码从自己仓库拉取到本地
安装 GitHub Desktop,访问官网。
等待 Clone 完成。
GitHub 为国外网站,所以下载起来会比较慢。
5、创建一个新的分支
6、修改需要修改的部分
加入新的内容。
7、提交推送
8、发起 PR
填写相关内容。
根据要求检查代码。
下面可以看到修改的内容。
检查没问题后点击按钮创建。
此时你就可以在 RT-Thread 仓库看到你发起的 PR 了。
管理员检测没问题就会合并你的代码进入主仓库了。


