跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言大前端

Git 提交规范:Conventional Commits 前缀使用指南

Git 提交规范通过语义化前缀明确修改目的,涵盖 feat、fix、refactor 等常见类型。统一格式为“前缀:描述”,建议控制在 50 字符内并关联 Issue 编号,便于版本追溯与管理。

1739658202发布于 2026/3/26更新于 2026/10/30101 浏览
Git 提交规范:Conventional Commits 前缀使用指南

在团队协作中,规范的 Git 提交信息能极大提升沟通效率。除了大家熟悉的 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 编号)

小结

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

目录

  1. 常用提交前缀及含义
  2. 书写建议
  3. 小结

更多推荐文章

查看全部
  • 基于 Microi 吾码低代码框架构建 Vue 高效应用
  • Open WebUI 与 Ollama 模型文件默认存储路径说明
  • 分治归并排序算法详解:逆序对与翻转对应用
  • llama.cpp 大模型部署指南:CPU/GPU 兼容与 Docker 快速启动
  • 国内升级 GitHub Copilot 专业版 PayPal 支付方案
  • 宇树科技机器人核心技术
  • Python 音乐推荐系统:Django+Echarts+协同过滤算法
  • OpenClaw 接入 QVeris:让 AI 助手具备实时数据查询能力
  • Python 实现 68 点人脸关键点检测实战
  • JavaWeb 数据交换与异步请求:JSON 和 Ajax 详解
  • Axios 错误处理的设计与进阶封装,实现网络层面的数据与状态解耦
  • 用 Python 把 CSV 导入 Neo4j 的实操记录
  • Antigravity Tools:用 Rust+Tauri 构建本地化 AI 调度网关
  • 医疗连续体机器人模块化控制界面设计与 Python 库应用研究
  • CSS 盒子模型详解:边框、内边距与外边距
  • 利用 Anthropic frontend-design Skill 提升大模型前端设计审美
  • 基于腾讯混元 3D 大模型实现静态图片转 3D 模型教程
  • GitHub 访问加速:本地 hosts 配置与 DNS 刷新指南
  • C++ 图论实战:深入理解三种最短路径算法
  • 2025 强网杯 Web 部分题目解题思路

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online