# Git Commit 消息简化规范
## 基础格式
<类型>(<范围>): <简短描述>
- 具体变更1
- 具体变更2
- 具体变更3
## 核心类型（记住这6个就够了）
| 类型 | 何时使用 | 示例 |
|------|----------|------|
| `feat` | 新增功能 | `feat(user): 添加注册功能` |
| `fix` | 修复bug | `fix(login): 修复密码验证问题` |
| `docs` | 文档更新 | `docs(api): 更新接口说明` |
| `refactor` | 代码重构 | `refactor(db): 优化查询性能` |
| `test` | 测试相关 | `test(auth): 添加登录测试` |
| `chore` | 杂项任务 | `chore: 更新依赖包` |
## 常用范围
- `(api)` - 接口
- `(ui)` - 界面
- `(auth)` - 认证
- `(db)` - 数据库
- 你的项目模块名
## 快速上手
### 1. 功能开发
bash
feat(订单): 支持优惠券使用
- 添加优惠券验证逻辑
- 更新订单金额计算
- 添加优惠券使用记录
### 2. Bug修复
bash
fix(支付): 修复重复扣款问题
- 添加支付状态检查
- 优化事务处理逻辑
- 添加重复请求防护
### 3. 代码优化
bash
refactor(用户): 重构权限检查
- 提取权限验证到独立服务
- 统一权限错误处理
- 优化缓存策略
### 4. 日常维护
bash
chore: 项目配置更新
- 更新README安装说明
- 调整Docker配置
- 清理无用依赖
## 实用技巧
### 标题要简短
bash
# ✅ 好
feat(auth): 添加微信登录
# ❌ 不好
feat(auth): 在我们的认证系统中添加了微信第三方登录的支持功能
### 正文用列表
bash
# ✅ 清晰
- 添加微信OAuth配置
- 实现回调处理
- 更新用户表结构
# ❌ 混乱
添加了微信OAuth配置，实现了回调处理逻辑，同时更新了用户表结构添加微信相关字段
### 一次提交只做一件事
bash
# ✅ 专注
feat(user): 添加头像上传
fix(api): 修复分页bug
docs: 更新部署文档
# ❌ 混杂
feat(user): 添加头像上传并修复分页bug同时更新文档
## 快速检查清单
- [ ] 类型选对了吗？（feat/fix/docs/refactor/test/chore）
- [ ] 范围明确吗？（模块或功能区域）
- [ ] 标题简短吗？（50字以内）
- [ ] 变更说清楚了吗？（破折号列表）
- [ ] 一次只做一件事吗？