GitHub 拉取请求工作流
在 GitHub 上发起拉取请求,撰写有帮助的描述,回复代码审查评论,并在获得批准后合并。
GitHub 拉取请求工作流 是 CoddyKit 上的免费 Frontend Academy 课时。 这是第 4 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Frontend Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Frontend Academy 课程共包含 4 节课。
什么是拉取请求?
拉取请求(PR)是将一个分支合并到另一个分支的提议。在 GitHub 上,它会创建一个讨论串,供队友评审代码、发表评论、请求修改,并最终批准合并。
在 GitHub 上创建 PR
将功能分支推送到 GitHub 后,会出现一个黄色横幅,提示您比较并创建 PR。请点击该横幅,或者前往“拉取请求”→“新建拉取请求”,然后选择您的分支。
编写优质的 PR 描述
优质的 PR 描述会解释:更改了什么以及为什么更改。对于界面更改,请附上屏幕截图。请链接相关问题单,并说明您如何测试了更改。读者不应需要阅读代码才能理解其意图。
## Summary
Adds dark mode support using CSS custom properties.
## Why
Users requested dark mode (#123). Reduces eye strain for evening use.
## Testing
- Toggled dark/light mode on macOS and Windows
- Verified `prefers-color-scheme: dark` auto-triggers
- Tested with a screen reader (macOS VoiceOver)请求评审者
请指定具体的队友作为评审者。他们会收到通知,并可以批准、请求修改或发表评论。大多数团队要求至少获得一项批准后才能合并。
阅读代码评审评论
评论会以内联方式显示在更改的代码行旁。评审者可以:请求澄清、建议不同的方法,或批准更改。请回复每条评论,可以通过修改代码,也可以说明不修改的理由。
响应修改请求
当评审者请求修改时,请将新的提交推送到同一分支。PR 会自动更新。处理完每条评论后,请点击“解决对话”来结束相应的讨论。
草稿 PR
将 PR 以草稿形式打开,以表明它仍在进行中。草稿 PR 仍然可以接受评审和讨论,但不会被意外合并。完成后,请将其转换为“准备就绪”状态。
保持分支最新
如果主分支在评审期间继续推进,请将您的分支变基到最新的主分支之上,以避免冲突,并确保您的更改能够与新代码一起正常工作。
git fetch origin
git rebase origin/main
git push --force-with-lease origin feature/dark-mode压缩合并、合并提交与变基
GitHub 提供三种合并策略:合并提交(保留所有提交)、压缩后合并(每个 PR 一个提交,使主分支历史记录整洁)、变基后合并(保持线性,不产生合并提交)。团队通常会选择一种策略以保持一致。
分支保护规则
请通过要求 PR 评审、要求状态检查通过(持续集成)以及禁止直接推送来保护主分支。您可以在 GitHub → 设置 → 分支中进行配置。
PR 礼仪
请让 PR 保持小而专注。每个功能或修复对应一个 PR。大型 PR 很难评审。请在一天内回复评审评论。请感谢评审者。请保持友善——代码评审是教学机会,而不是审计。
快速检查
优质的 PR 描述应包含哪些内容?
回顾:拉取请求工作流程
推送功能分支 → 撰写清晰的描述并打开 PR → 请求评审者 → 通过新的提交处理反馈 → 通过变基保持分支最新 → 获得批准 → 合并。请让 PR 保持小巧、专注且描述清晰。分支保护规则会在主分支上强制执行质量要求。
常见问题解答
「GitHub 拉取请求工作流」课时是免费的吗?
是的 — 「GitHub 拉取请求工作流」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Frontend Academy 课程的其余内容,请升级到 CoddyKit PRO。 Frontend Academy 课程共包含 4 节课。
「GitHub 拉取请求工作流」这节课中我会学到什么?
在 GitHub 上发起拉取请求,撰写有帮助的描述,回复代码审查评论,并在获得批准后合并。 你通过在浏览器中直接运行的动手代码来练习 Frontend Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Frontend Academy 需要有经验吗?
无需任何先前经验。CoddyKit 上的 Frontend Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 4 节课,共 4 节。
「GitHub 拉取请求工作流」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 Frontend Academy 课中编写并运行代码吗?
能。每节 Frontend Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。