打开你的项目跑一下 git log
说实话,你现在就可以打开终端,在你的项目里跑一下 git log --oneline,看看过去 20 条 Commit Message 长什么样。
如果你看到的是这样的:
a3b2c1d fix bug
f4e5d6c update
8g7h6i5 修了一下
j9k0l1m 改了点东西
n2o3p4q wip
r5s6t7u asdfgh
这种历史无法说明每次修改的目的,也很难安全回滚。团队协作需要让每个 Commit 都有明确范围和可验证意图。
你可能觉得这是小题大做。Commit Message 不就是给自己看的吗?代码能跑就行了嘛。
不是这样的。 在真实的团队工作中,Commit Message 的重要性远超大多数人的想象。

Commit Message 到底给谁看?
给未来的你
三个月后,你的代码出了一个 Bug,你需要回溯是哪次修改引入的。你打开 git log,看到 20 条"fix bug"——你怎么知道是哪个"fix bug"引入的新问题?但如果 Commit Message 写的是"fix: resolve infinite loop in price calculation when discount is 0",你一眼就知道这条跟价格计算有关。
给你的队友
Code Review 的时候,Reviewer 首先看到的就是你的 Commit Message。一个写着"feat: add user email verification flow with resend limit"的 PR,Reviewer 打开之前就已经知道大概改了什么。但一个写着"update code"的 PR?Reviewer 得把每个文件的 diff 都看一遍才能搞明白你到底做了什么。
给招聘经理
越来越多的公司在面试时会要求你提供 GitHub 链接。面试官翻看你的 Git 历史,如果看到清晰规范的 Commit,第一印象分直接拉满。这不是玄学——我亲眼见过 Tech Lead 因为候选人的 Git 历史"太乱"而扣分。
差的 Commit vs 好的 Commit
来看一组对比,感受一下差距:
| 差的 Commit Message | 好的 Commit Message |
|---|---|
fix bug | fix: prevent crash when user profile image is null |
update styles | style: redesign login page with mobile responsive layout |
add feature | feat: implement shopping cart with quantity adjustment |
修了一下 | fix: correct tax calculation for GST-free items |
wip | wip: partial implementation of OAuth2 Google login |
AI 时代,写好 Commit 更容易了
话说回来,以前你可能觉得写好 Commit Message 很麻烦——每次都要想措辞、想分类。但现在有了 AI,这件事变得几乎零成本。Claude Code 可以直接帮你分析代码改动然后生成 Commit Message,Cursor 也可以。你只需要做一件事:告诉 AI 你们团队用什么规范。
这就是我们下一步要讲的——Conventional Commits。
你的 Git 历史长什么样?
为什么 Commit Message 写得好坏直接影响你在团队里的形象