分支、合并与 Pull Request：新手也能安全协作

分支把未完成的试验和稳定版本隔离开；Pull Request 让一组改动拥有明确目标、可审查 diff 与验证记录。即使一个人开发，也能借此减少误合并。

你会学到什么

• 从 main 创建功能分支。

• 写出可审查的 PR。

• 处理合并前的检查与冲突。

动手步骤

• 切换 main 并同步远程。

• 创建描述单一目标的分支。

• 小步提交、运行测试并推送分支。

• 创建 PR，写明背景、改动、风险和验证方式。

最小示例

git switch main
git pull --ff-only
git switch -c feat/login-form
git add src/login.ts
git commit -m "feat: add login validation"
git push -u origin feat/login-form

容易踩坑的地方

• 一个分支不要混入重构、格式化和不相关功能。

• 冲突不是失败，而是需要确认两边意图。

• 不要在 CI 失败时只重跑而不读第一条错误。

完成前检查

• 分支服务一个目标。

• PR 含测试说明。

• 合并后删除已完成分支并同步 main。

延伸阅读

• GitHub Docs：About pull requests：https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests

• Git Book：Branches：https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell