5.2 版本控制作为团队记忆

版本控制不只是备份。它记录系统如何变化、谁评审过、接受了哪些取舍，以及变更错误时如何恢复。

Git 保存快照。好的团队用这些快照讲出连贯的工程故事。

提交作为推理单位

一个提交通常应该：

• 聚焦：只有一个逻辑变化理由。
• 可评审：小到能理解。
• 可回滚：回滚时不会拖着无关工作。
• 有解释：提交信息说明 why，而不只是 what。

弱提交信息：update stuff

更好：Guard invoice export behind report permission

更好的正文：解释用户或安全原因，并提到测试或迁移注意事项。

分支与 Pull Request

分支隔离工作。Pull Request 围绕一次变更创建可评审对话。

好的 PR 通常包括：

• 问题陈述。
• 方案总结。
• 风险区域。
• 测试证据。
• 当行为可见时提供截图或例子。
• 有生产风险时说明发布或迁移注意事项。

合并也是产品决策

合并不只是 Git 事件。它改变了团队现在拥有的东西。如果一个变更难回滚、难观察、难解释，PR 应该在合并前让这些风险可见。

版本控制给你历史。工程纪律让这段历史有用。