在团队协作开发中，维护一份清晰的 Git 提交记录至关重要。业界广泛推行的 Conventional Commits 规范，通过语义化的前缀让每次提交的目的一目了然。除了大家熟悉的 feat 和 fix，这套体系还涵盖了重构、文档、测试等多个维度的标识符。
常用提交前缀对照表
| 前缀 | 中文含义 | 典型场景示例 |
|---|---|---|
| feat | 新增功能 | feat: 新增商品详情页分享功能 |
| fix | 修复 Bug | fix: 修复移动端下拉刷新数据重复的问题 |
| refactor | 代码重构 | refactor: 重构订单列表组件，优化代码结构 |
| docs | 文档修改 | docs: 更新 README 中的接口使用说明 |
| style | 代码格式调整 | style: 格式化代码缩进，修正变量命名规范 |
| test | 测试相关 | test: 为用户登录接口添加单元测试 |
| chore | 琐碎工作 | chore: 升级依赖包 axios 到 1.6.0 版本 |
| perf | 性能优化 | perf: 优化商品列表查询 SQL，提升接口响应速度 |
| build | 构建相关 | build: 调整 webpack 配置，减小打包体积 |
| ci | CI/CD 配置 | ci: 调整 GitHub Actions 自动化部署流程 |
| revert | 回滚提交 | revert: 回滚到 commit 1234567，撤销上一次的功能修改 |
| release | 版本发布 | release: 发布 v1.2.0 版本 |
书写建议与最佳实践
实际落地时，保持格式统一是第一步。推荐采用「前缀 + 冒号 + 空格 + 简短描述」的结构。描述部分用中文或英文皆可，建议根据团队习惯选择，首字母无需大写，结尾也不必加标点符号。例如：perf: 优化首页图片加载速度。
其次，描述要尽量克制，控制在 50 个字符以内，确保一眼就能看懂本次提交的核心意图。如果遇到特定 Bug 修复，可以在描述后补充关联的 Issue 编号，方便后续追踪，比如 fix: 修复支付回调签名验证错误 #123。
归根结底，规范提交的核心在于利用语义化前缀明确目的。结合 Issue 编号、版本号等信息，能让提交记录更易追溯和管理，为后续的自动化发布和日志分析打下基础。
