把 Git 提交拆成可以解释的变化

一次提交最好能够用一句具体的话说明它改变了什么。

2026.11.04编程与协作短篇笔记
文档与工具的抽象插图

按目的拆分

修复一个问题、增加一个行为、整理一段结构,通常可以分别成为提交。判断标准不是改动行数,而是这些变化是否需要一起被理解、一起被撤销。

提交前读一遍差异

git diff 用来查看尚未暂存的变化,git diff --cached 查看已经暂存的变化。检查时留意临时输出、配置样例和无关格式化是否混进了本次修改。

git status --short
git diff
git diff --cached

写出行为和原因

提交说明先描述结果,例如“在空列表时显示引导文字”。如果原因不能从代码直接看出,再补充触发条件。避免只写“更新”“修复一些问题”。

继续读