Git：一次提交只说明一件事

建站演示文章：用于展示本站的内容与排版，可按需要替换为自己的笔记。

先看差异，再做提交

提交前先确认自己改了什么。下面的命令只查看仓库状态和工作区差异：

git status --short
git diff

如果工作区同时包含文章内容和一项无关样式改动，可以分别提交。以后定位问题时，单一目的的提交更容易解释。

选择这一次需要的文件

git add docs/notes/engineering/git.md
git diff --cached
git commit -m "docs: add a note about focused commits"

暂存区差异是提交前的最后一遍检查。它展示将进入当前提交的内容，不等同于所有未保存或未暂存的改动。

留意敏感信息

提交前检查示例文件中是否出现令牌、密码或私有地址。公开静态站点中的文件不能保存秘密。

写能看懂的说明

“更新”很难帮助未来的自己。可以把说明改成“补充文章的图片路径示例”，明确对象和动作。复杂改动再补充原因，小改动不需要冗长模板。

验证与提交保持对应

修改文章后，查看页面是否排版正常；修改构建配置后，再验证构建。记录自己实际做过的检查，不把“应该没问题”当作通过。

版本历史的价值在于说明变化。每一次提交都能回答“解决了什么问题”，就已经足够有用。