别再写“fix bug”了！团队 Git 提交规范，从入门到自动强制执行
别再写“fix bug”了！团队 Git 提交规范，从入门到自动强制执行
你的团队提交记录，是不是也长这样？
fix bug update 修改了一下 111如果你曾在凌晨三点，对着git log追溯一个线上 Bug，翻遍几百条提交也找不到它到底是谁、在哪个需求里引入的——那你一定明白我在说什么。
Commit Message，是项目里最被低估的文档。它不用单独维护，却伴随代码永久留存。写得烂，每次排查问题都是一场考古噩梦；写得好，它就是项目自带的“变更日志”。
更扎心的是，提交信息乱只是表象。提交的内容本身有没有坑，才是真正要命的事。空指针没判、边界没处理、调试代码没删——这些代码一旦进了仓库，修复成本翻十倍。
这篇文章，我会讲三件事：
- 一套好的提交规范长什么样
- 提交前怎么自动查出隐藏的 Bug
- 如何让团队自动遵守规范，而不是靠吼
一、Conventional Commits：一条好标题，就够用
目前社区最主流的规范是 Conventional Commits，基础格式非常简单，就一行：
<type>(<scope>): <subject>常见的 type：
feat：新功能fix：修 Bugrefactor：重构（不修 Bug 也不加功能）docs：文档style：格式（不影响代码运行）test：测试相关chore：构建、依赖等杂务
scope是可选的影响范围，比如order、payment、user。
subject用一句话说清楚做了什么。
举几个规范提交的例子：
feat(order): 增加订单超时自动取消逻辑 fix(payment): 修复金额计算精度丢失问题 refactor(user): 提取用户校验逻辑到独立模块就这一行，已经能回答三个关键问题：
- 做了什么：超时取消、修精度、提取校验
- 影响哪里：order、payment、user
- 什么类型：新功能、修 Bug、重构
如果整条主干分支都保持这个规范，发版时用脚本归类feat和fix，就能自动生成发布说明。追溯任何一行代码的提交意图，也只要看一眼标题。
二、提交前审查：别等代码进了仓库再后悔
规范提交解决了“说得清”的问题，但还有另一个更要命的问题：这次提交的代码本身，有没有坑？
大多数团队把质量检查压在 Code Review 环节。但现实是：
- Review 的人自己也有一堆需求要赶，只能粗略扫一遍
- 肉眼审查能发现命名和结构问题，但很难揪出“这个判断条件少了一个分支”这种逻辑漏洞
- 等 Review 发现问题，代码已经推上去了，再改又是一轮提交
真正划算的做法，是把审查前置到提交之前。写完代码，还没 commit，先让工具帮你过一遍。
我在用的方案是：提交前自动扫描本次变更，按严重程度给出分级报告——
🔴 致命问题 - src/order.ts:42 空指针风险：未判断 order 是否为 null 即调用属性 🟡 逻辑风险 - src/user.ts:15 useEffect 缺少依赖项 userId，可能导致状态不同步 🟢 规范建议 - src/utils.ts:88 函数 getData 超过 40 行，建议拆分 🔵 性能隐患 - src/list.tsx:23 列表渲染未使用 key，可能造成不必要的重绘 🟣 安全漏洞 - src/api.ts:10 硬编码了数据库连接字符串，有泄露风险等于每次提交前，有一个免费的 Reviewer 帮你把变更逐行捋一遍。我用了一段时间，至少有三次它在我点提交之前拦下了边界条件没处理的问题。提交前拦住一个 Bug，比合并后修一个 Bug，成本低十倍不止。
三、靠人遵守规范？那规范迟早变成废纸
“提交前检查一下就行”听起来很美，但现实是：
- 新人入职第一周，不知道有规范
- 赶需求到晚上十点，只想
git commit -m "done" - Leader 逐条检查，一天不用干别的了
规范要落地，不能靠人的自觉，必须靠系统兜底。
最基础的兜底是 Git Hook，比如commit-msg这个钩子，可以在提交时用正则检查格式。但它的体验很差——只会告诉你“格式不对”，却不帮你改。开发者被拦下来，还是要自己对着规范文档重新措辞，多了一道恼人的步骤。
更好的方案是：在 IDE 里，写完代码直接帮你生成规范 Commit，同时自动扫描一遍变更有没有坑，一步到位。
四、一个插件搞定：生成 + 审查 + 拦截
我在 VSCode 里装了一个叫git ai commit的插件，它把上面说的这些事整合在了一起。在点提交按钮之前，做三件事：
① 一键生成规范化 Commit 标题
读完你的 diff，自动生成一条简洁准确的标题：
fix(payment): 修复金额计算未处理小数进位导致的精度丢失 feat(order): 新增订单超时自动取消并释放库存 refactor(api): 统一错误处理中间件不用自己写，不用管格式，直接符合 Conventional Commits。
② 提交前自动代码审查
同一个界面，点一下“审查变更”，它会把本次改动的代码扫一遍，按致命问题、逻辑风险、规范建议、性能隐患、安全漏洞五个维度输出报告。每次提交前花十秒看一眼，能拦下大部分低级失误。
③ 团队规范的强制执行
Leader 可以后台配置规则，比如：
- 提交标题必须关联 Jira 编号
- 禁止提交
debugger、console.log - 分支命名必须匹配
feature/*或bugfix/*
规则一旦设定，团队成员提交时不符就直接被拦截，没法绕过去。这套机制把“团队规范”从口头约定变成了系统能力，新人不需培训，上手即合规。
五、和大厂工具比，它有什么不同
有人会问：GitHub Copilot 也有生成 Commit 的扩展，为什么不用那个？
实测下来，核心差异在于定位：
- Copilot 等大厂工具的主战场是帮你写代码，Commit 生成只是一个附属功能，深度有限。代码审查更是几乎没有
- git ai commit 只聚焦“提交时刻”这一件事——生成规范 Commit + 提交前审查 + 强制规范拦截，深度和完整度远超大厂的附属小功能
另一个差异是数据安全。所有大厂工具都需要把代码发到云端处理，而 git ai commit支持本地模型模式，代码不出内网。对有合规要求的团队来说，这是硬性门槛。
六、怎么开始用
目前支持的套餐大概是：
- 个人免费版：每天有限次使用，够轻度开发者日常
- 按次包：¥1.9 买 100 次，适合想先试试的人
- 年度会员：¥99/年，无限次
- 团队买断：¥19.9/人，适合小团队一次性搞定
个人建议先花 1.9 元买 100 次试试，看它生成的 Commit 质量和审查报告准不准，再决定要不要团队推广，成本基本忽略不计。
安装方式：VSCode 插件市场搜索git-ai-commit即可。
七、写在最后
写这篇文章，不是为了推销一个插件。而是我真的觉得，代码提交质量这个环节，被整个行业严重低估了。
大家都卷“怎么写得更快”，很少有人卷“怎么提交得更清晰、更安全”。但后者才是一个项目能健康跑三年的基础。
如果你正好也在为团队的提交规范和代码质量头疼，不妨试一下这个思路：别再靠人遵守规范，让工具来兜底。每次提交前，先审一遍再入库。
在 VSCode 中安装 git-ai-commit
（本文与 git ai commit开发者无利益关联，纯属个人使用推荐。）