第 9 章 · Pull Request 与 Code Review
本章目标：在 GitHub 网页 创建 Pull Request（PR）；写清楚 做了什么、怎么测；按 Review 评论在工作台改代码、再 push 更新 PR；理解 工作台审阅条 与 PR Review 两道关；Merge 后本地 main pull 同步。
学时建议：3.5～4 小时（含 2 小时跟练）
前置：git-collab ch08（feature 已 push）；ch05 知合并概念。
9.1 场景说明：功能做完了，不能直接推 main
团队规定 shop-demo 的 main 受保护：
- 不能直接 push
- 必须 PR + 至少 1 人 Approve 才能合并
你在 feature/product-filter 上开发完成、自测通过、也已 push。下一步：在 GitHub 请求合并，让同事看 diff、提意见，通过后 Merge。
PR 不在工作台菜单里点「合并 PR」——创建、Review、Merge 主要在 浏览器 GitHub；工作台负责 改代码、commit、push 更新 PR。
9.2 学完你能
| 能力 | 验收 |
|---|---|
| 开 PR | base=main，compare=feature |
| 写说明 | 含变更摘要 + 测试步骤 |
| 更新 PR | 同分支再 commit + push |
| Review | 读懂 Request changes / Approve |
| Merge 后 | 本地 main pull，可选删 feature |
| 双审 | 审阅条 + PR 两道关 |
9.3 PR 是什么（给同事的一封「合并申请」）
feature/product-filter ──PR──► main
（你的提交） （稳定线）PR 页面展示：
- Files changed（diff）
- Commits 列表
- Conversation（评论）
- Checks（ch11 CI 绿勾）
合并 = 把 feature 的改动合进 main（类似 ch05 合并，但在 GitHub 上完成并留记录）。
9.4 跟练 A：自开自审 PR（个人仓库必做）
步骤 1 — 准备 feature 分支
cd ~/dev-workspace/shop-demo
git checkout main
git pull origin main
git checkout -b feature/ch09-pr-demo改 README.md 加一节：
## 商品筛选（PR 演示）
- [ ] 列表页增加分类下拉
- [ ] 单元测试通过暂存 → 提交：feat: PR 演示说明
推送到 GitHub
步骤 2 — 浏览器开 PR
- 打开 GitHub 仓库
- 推送后常出现黄色条 Compare & pull request，点击
- base:
main← compare:feature/ch09-pr-demo - 标题：
feat: 商品筛选 PR 演示 - 说明模板：
## 变更
- README 增加筛选功能 checklist
## 怎么测
1. 打开 README 确认新章节存在
2. （真实功能时写：启动 api、curl、截图）
## 截图
（可选）- Create pull request
步骤 3 — 自己 Review（练习）
PR 页 → Files changed → 点 Review changes → Comment 或 Approve（个人练习可自 Approv）。
步骤 4 — Merge
Merge pull request → 确认 → Confirm merge
步骤 5 — 本地同步 main
工作台：
git checkout main
git pull origin main你应该看到 README 里 PR 那节已在 main 上。
步骤 6 — 清理分支（可选）
GitHub 上 Delete branch；本地：
git branch -d feature/ch09-pr-demo