Checkpoint: 协作开发

你将完成什么

1. 用 Git 分支管理多人协作
2. 用 Pull Request 审查代码
3. 解决合并冲突

验收标准

1. 每人在 feature 分支开发
2. 提交规范（Conventional Commits）
3. PR 审查通过后合并

工作流程

1. 创建功能分支

# 从 main 分支创建
git checkout main
git pull origin main
git checkout -b feature/add-login

# 开发、提交
git add .
git commit -m "feat: add login page"
git push origin feature/add-login

2. 发起 Pull Request

# GitHub 网页操作：
# 1. 进入仓库 → Pull requests → New pull request
# 2. base: main  compare: feature/add-login
# 3. 填写标题、描述
# 4. 指派审查人
# 5. 提交

3. 代码审查

# 审查人：
# 1. 查看 Files changed
# 2. 点击行号添加评论
# 3. 提出问题或建议
# 4. Approve 或 Request changes

# 作者：
# 1. 回复评论
# 2. 修改代码
# 3. 推送更新（自动更新 PR）
# 4. 请求重新审查

4. 解决冲突

# 合并时出现冲突
git checkout feature/add-login
git pull origin main

# 解决冲突文件
# 编辑文件，保留需要的代码，删除冲突标记

# 标记已解决
git add .
git commit -m "merge: resolve conflict"
git push origin feature/add-login

5. 合并

# GitHub 网页：
# 1. 审查通过后，点击 Merge pull request
# 2. 选择合并方式：
#    - Create a merge commit（保留历史）
#    - Squash and merge（合并成一个提交）
#    - Rebase and merge（线性历史）
# 3. 删除功能分支

提交规范

# 格式：type(scope): subject

git commit -m "feat(auth): add JWT login"
git commit -m "fix(api): handle null user"
git commit -m "docs: update README"
git commit -m "style: format code"
git commit -m "refactor(db): extract connection pool"
git commit -m "test: add user tests"
git commit -m "chore: upgrade dependencies"

常见卡点

1. 冲突太多：频繁从 main 分支拉取最新代码，减少冲突。
2. PR 太大：拆分成多个小 PR，每个 PR 只做一件事。
3. 审查不通过：认真对待每条评论，解释或修改。

加分项

• 用 GitHub Actions 自动测试
• 配置分支保护（必须 PR + CI 通过才能合并）
• 用 CODEOWNERS 文件自动指派审查人

下一步

完成本课后，进入「自动化」阶段，学习 CI/CD。