你有没有过这样的经历：几个月前写的代码，现在想回顾某次修改的细节，打开Git提交记录一看，全是“修改了”“改了一下”“修复bug”这种模糊的描述，根本不知道到底改了啥？或者团队协作时，别人提交的代码记录混乱，想快速找到某个功能的变更，结果翻半天都找不到头绪？这时候，清晰的Git提交信息（commit message）就派上用场了。
什么是commit message？¶
每次用 git commit 提交代码时，你写的那段说明文字，就是commit message。它就像代码变更的“日记”，需要简明扼要地告诉别人（包括未来的自己）：这次提交到底做了什么？为什么这么做？
为什么要写清晰的commit message？¶
你可能觉得“随便写两句就行”，但清晰的commit message其实有很多隐藏好处：
1. 快速回忆：拯救“失忆”的自己¶
假设你在半年前做了一个项目，现在想优化其中一个功能，打开历史记录发现：“commit 1: 修改代码”“commit 2: 改bug”……完全想不起具体改了啥。但如果commit message是“fix: 修复支付页面金额计算错误”，你一眼就能明白这是针对支付功能的修正，节省大量时间。
2. 团队协作：让沟通更顺畅¶
团队里每个人的提交记录需要共享。比如前端同事改了登录页面样式，后端同事需要看是哪个提交影响了接口，而清晰的commit message能帮他们快速定位。比如“feat(login): 添加手机号验证码登录”，直接告诉大家：这是新增了验证码登录功能，作用域是login模块。
3. 自动化工具：让工具“看懂”你的代码¶
很多工具依赖commit message自动工作。比如：
- 生成版本日志（CHANGELOG）：根据不同类型的commit（如fix、feat）自动生成版本更新说明，不需要手动汇总。
- 自动升级版本号：规范的commit message能让工具判断版本类型（比如fix对应补丁版，feat对应小版本），自动帮你更新package.json里的版本号。
4. 快速定位问题：像侦探一样抓bug¶
如果线上出了bug，需要用 git bisect 快速定位哪次提交导致的。清晰的commit message能帮你快速缩小范围。比如：“fix(checkout): 修复购物车结算按钮重复点击问题”，直接指向问题类型和模块，比模糊的“改了购物车”快得多。
最简单的规范：至少包含“类型+描述”¶
刚开始不用追求复杂规范，先养成一个简单的习惯：明确“这次提交是做什么的”，最好包含“类型”和“核心内容”。
常见类型（选2-3个基础的用就行）：¶
fix：修复bug（比如“fix: 修复用户注册失败的问题”）feat：新增功能（比如“feat: 添加商品搜索功能”）docs：文档更新（比如“docs: 补充API接口说明文档”）style：格式调整（比如“style: 统一代码缩进格式”，不影响功能逻辑）refactor：重构代码（比如“refactor: 将重复的登录逻辑拆分为函数”）
示例：¶
# 基础版
git commit -m "fix: 修复登录按钮点击无反应的问题"
# 进阶版（带作用域，可选）
git commit -m "feat(home): 新增首页轮播图组件"
(home)是作用域，说明修改的是home模块；fix/feat是类型，说明修改的性质；- 后面是简洁的描述，只写核心内容，别太啰嗦。
更规范的选择：Conventional Commits规范¶
如果你想让commit message更标准化，推荐参考 Conventional Commits 规范。它的格式更严格，能被工具自动解析，适合多人协作项目。
核心格式：¶
<类型>[可选作用域]: <描述>
[可选正文]
[可选脚注]
常用类型：¶
feat：新功能（比如“feat: 新增用户个人中心页面”）fix：修复bug（比如“fix(auth): 修复验证码过期后重新发送功能”）docs：文档更新（比如“docs: 补充README.md安装步骤”）chore：日常任务（比如“chore: 更新依赖包版本”，不影响代码逻辑）
示例：¶
# 带正文和脚注（可选，进阶用）
git commit -m "feat(cart): 新增购物车商品数量修改功能
- 支持+/-按钮调整数量
- 同步更新总价计算
Fixes #123 # 关联issue编号，可选"
新手实践小技巧¶
- 先从“类型+描述”开始：哪怕一开始只用
fix/feat，后面再逐步加作用域和细节。 - 写在提交前10秒：每次提交前，花10秒想清楚“这次改了啥核心内容”，避免事后回忆不清。
- 用工具辅助：推荐
cz-cli（交互式提交，自动帮你选类型、写描述），或者commitlint（检查格式是否合规），安装后能减少犯错率。
总结¶
清晰的commit message不是“负担”，而是提升代码管理效率的“快捷方式”。它能让你和团队成员更快理解代码变更，也能让工具帮你自动化处理版本、日志等琐事。从今天起，每次提交前花5秒想想“这次要写什么”，坚持下去，你会发现代码仓库变得更“好懂”了！