代码能跑和代码好维护是两回事，而 commit message 是团队协作里最容易偷懒、也最影响可读性的环节。这篇讲清楚 Git commit 规范 怎么定、怎么写，以及当你“提交完才发现写错/漏文件”时，如何用 git commit –amend 用法 和交互式 rebase 安全地 修改历史提交技巧。
一、一条好 message 的结构
业界常用“类型: 简述”开头，例如 feat: 新增导出 Excel 功能、fix: 修复空指针导致崩溃。类型涵盖 feat/fix/docs/refactor/test/chore。好的 写好提交信息的方法 是：标题用祈使句、控制在 50 字内，需要解释时空一行写正文，说明“为什么改”而非“改了什么”（代码本身会说话）。
二、amend：改最近一次提交
刚提交完发现漏了文件，或错别字，别急着再 commit 一个“补”。git commit –amend 用法 能把它合并进上一次：git add 漏的文件 后 git commit --amend --no-edit 只补内容不改信息，或去掉 --no-edit 顺手改信息。注意：amend 会改写那次提交的哈希，只适用于“还没推送到公共分支”的提交。
三、改更早的历史：交互式 rebase
要 修改历史提交技巧 中更早的几条，用 git rebase -i HEAD~3 列出最近 3 条，把想改的那行由 pick 改成 reword（只改信息）或 edit（改内容）。reword 直接编辑信息；edit 会在那次提交停下，你改完 git commit --amend 再 git rebase --continue。
3.1 改历史的红线
任何已经推送到共享分支的历史都不要改，否则队友的本地仓库会和远程“分叉”，合并时一团乱。改历史只限你自己的、未推送的提交，或明确知会团队后强推（force-with-lease）。
四、规范可以工具化
用 commitlint + husky 在提交时自动校验 message 格式，比靠人记靠谱。把规范写进仓库的 CONTRIBUTING，新人照着来即可。在 WordPress 这类项目中，哪怕是主题模板的微调（如 锚点链接直达选项卡表单 的改动），提交信息写清楚也能让日后回溯轻松——这也是我们整理 图片链接获取附件 ID、MemberPress 汉化包 这类改动时坚持的做法。
小结
commit message 是写给“未来的自己和同事”看的。Git commit 规范 不必追求完美模板，但“类型清晰 + 标题达意 + 不滥用 amend 改公共历史”这三条守住，仓库可读性会质的提升。下次手滑提交前，先想一秒：这条信息半年后看得懂吗？
暂无评论内容