Git 提交信息的规范化简写格式

Git 提交信息的规范化简写格式

你想了解的是 Git 提交信息的规范化简写格式(也常被称为 Conventional Commits 规范),除了 feat、fix、refactor 之外,还有很多不同类型的前缀可以让提交信息更清晰、更有语义。

在这里插入图片描述

完整的规范提交前缀及含义

以下是业界通用的 Conventional Commits 规范中常用的前缀,按使用场景分类,每个前缀都有明确的语义:

前缀中文含义使用场景举例
feat新增功能feat: 新增商品详情页分享功能
fix修复 Bugfix: 修复移动端下拉刷新数据重复的问题
refactor代码重构(无功能变更)refactor: 重构订单列表组件,优化代码结构
docs文档修改docs: 更新 README 中的接口使用说明
style代码格式调整(无逻辑变更)style: 格式化代码缩进,修正变量命名规范
test测试相关test: 为用户登录接口添加单元测试
chore琐碎工作(构建/工具等)chore: 升级依赖包 axios 到 1.6.0 版本
perf性能优化perf: 优化商品列表查询 SQL,提升接口响应速度
build构建相关(打包/编译)build: 调整 webpack 配置,减小打包体积
ciCI/CD 配置修改ci: 调整 GitHub Actions 自动化部署流程
revert回滚提交revert: 回滚到 commit 1234567,撤销上一次的功能修改
release版本发布release: 发布 v1.2.0 版本

规范提交信息的书写建议

  1. 格式统一:前缀 + 冒号 + 空格 + 简短描述(描述用中文/英文均可,建议中文更贴合团队习惯,首字母无需大写,结尾不加标点)。
    示例:perf: 优化首页图片加载速度
  2. 描述简洁:尽量控制在 50 个字符以内,清晰说明本次提交的核心内容。
  3. 特殊场景补充:如果修复的是特定 Bug(如关联 Issue),可以在描述后补充:
    示例:fix: 修复支付回调签名验证错误 #123(#123 为 Issue 编号)

总结

  1. Git 规范提交的核心是通过语义化前缀明确提交目的,常用前缀包括 feat/fix/refactor/docs/style/test/chore/perf 等;
  2. 提交信息格式统一为「前缀: 描述」,简洁且能精准体现修改内容;
  3. 结合 Issue 编号、版本号等信息,可让提交记录更易追溯和管理。
Could not load content