在团队协作开发中Git 提交信息Commit Message不仅仅是代码变更的“日记本”更是项目版本管理语义化版本、自动化生成 Changelog 以及快速定位问题的核心依据。目前业界最广泛采纳的标准是Conventional Commits约定式提交。除了大家最熟悉的feat、fix、perf之外一套完整的提交类型体系究竟包含哪些本文将为你全面梳理常用的 11 种提交类型并附上实战避坑指南。一、核心三兄弟功能、修复与性能这三者是日常开发中使用频率最高的是提交信息的“基本盘”。类型全称核心场景版本号影响示例featFeature新增用户功能或业务逻辑MINOR(次版本号)feat: 增加会员等级积分倍率fixBug Fix修复线上或测试环境的缺陷PATCH(修订号)fix: 修复订单状态机流转异常perfPerformance优化性能降低响应时间/资源消耗PATCHperf: 优化首页大图懒加载机制特别注意perf属于“优化”而非“新增”。如果修改代码仅是为了跑得更快但用户操作路径没有任何变化必须使用perf。反之如果新增了缓存策略但改变了用户交互则属于feat。二、代码质量与维护类高频这部分主要用于代码内部整改不影响最终用户功能但对项目长期健康至关重要。类型全称核心场景示例refactorRefactoring重构代码优化结构、消除冗余不修 Bug、不改功能、不提性能refactor: 抽离公共请求拦截器styleStyle仅修改代码格式空格、缩进、分号或CSS/UI 样式调整不影响逻辑style: 调整按钮圆角与阴影效果testTest添加、修改或修复单元测试 / E2E 测试用例test: 增加支付回调异常场景覆盖三、工程化与辅助类低频但必备这类提交通常不进入生产环境代码包但却是研发流程的基石。类型全称核心场景示例choreChore构建工具、包管理器、CI/CD 配置、依赖升级等杂务chore: 升级 Vue 3.4 并更新相关生态依赖docsDocumentation仅修改文档README、API 文档、Javadoc 注释docs: 更新部署环境变量说明ciContinuous Integration修改 CI 配置文件或脚本如 GitHub Actions、Jenkinsci: 增加 Node 20 构建矩阵四、紧急恢复类保命专用类型全称核心场景示例revertRevert回退某一次历史提交通常用于紧急线上事故回滚revert: 回退 feat: 增加灰度发布逻辑规范要求revert提交信息必须附带被回退提交的commit hash。五、容易被忽视的扩展类型在某些特定项目如开源库、移动端中以下类型也常被使用类型全称使用场景buildBuild影响编译/打包系统如 Maven/Gradle 配置、webpack 基础配置i18nInternationalization国际化文案的增删改某些团队会将其归入feat或docs六、极易混淆的“三座大山”实战避坑在实际 Code Review 中以下三种情况最易引发争论请务必牢记判断逻辑1.refactorvsperfvsfix场景重写了列表渲染逻辑。若运行速度没变代码更整洁 →refactor。若运行速度明显提升逻辑结果不变 →perf。若原本列表数据渲染有错如漏了一条重写后修复 →fix。2.stylevsfeat场景修改了按钮的颜色和位置。若只是视觉微调无新交互→style。若新增了悬浮下拉菜单新能力→feat。3.chorevsbuild场景升级webpack从 v4 到 v5。若修改了webpack.config.js→build如果团队细分了这个类型。若仅仅修改package.json并执行npm install→chore。七、标准提交格式附模板遵循规范时建议使用以下标准格式type(scope): subject BLANK LINE body BLANK LINE footertype上述任一提交类型。scope可选影响范围如模块名、组件名。subject必填简短描述首字母小写结尾不加句号。body可选详细说明修改动机和与之前实现的差异。footer可选关闭的 Issue 号如Closes #123或 BREAKING CHANGE 说明。范例feat(订单): 增加跨境税费自动计算 新增根据收货地址和商品类目自动匹配税率逻辑集成外部税引擎接口。 Closes #445八、给团队的落地建议工具化强制约束建议接入CommitlintHusky在 Git Hook 阶段自动拦截不合规的提交信息。交互式生成推荐使用Commitizencz-cli通过 CLI 问答引导开发者生成标准格式彻底杜绝“手敲拼写错误”如将feat打成feta。版本自动化结合standard-version或semantic-release可根据提交类型自动升级版本号并生成CHANGELOG.md实现真正的 DevOps 闭环。总结分类常用类型一句话口诀功能/修复feat/fix加功能、修缺陷质量/性能perf/refactor/style提性能、整结构、调样式辅助/工具chore/docs/ci/test改工具、写文档、配流水线、补测试良好的提交规范不是为了束缚开发者而是为了在 3 个月后当你或同事翻开 Git Log 时能在一秒内读懂“这个提交到底改了啥为什么要改”。从今天起规范化你的每一次git commit吧