# Emoji Conventional Commits

本项目采用 emoji conventional commits 规范，确保 commit message 清晰、一致且易于追踪。

## Emoji 列表

| Emoji | Type | 描述 | 示例 |
|-------|------|------|------|
| ✅ | feat | 新功能、新特性 | ✅ feat: 添加用户认证功能 |
| 🐛 | fix | Bug 修复 | 🐛 fix: 修复登录页面样式问题 |
| 📚 | docs | 文档更新 | 📚 docs: 更新 API 文档 |
| 💄 | style | 代码格式调整 | 💄 style: 修复缩进问题 |
| 🧹 | refactor | 重构代码 | 🧹 refactor: 优化数据库查询 |
| 🧪 | test | 测试相关 | 🧪 test: 添加用户注册测试 |
| ⚙️ | chore | 构建工具或依赖变更 | ⚙️ chore: 更新依赖版本 |
| 🚀 | perf | 性能优化 | 🚀 perf: 优化页面加载速度 |
| 🎯 | release | 发布新版本 | 🎯 release: v1.2.0 |
| ❌ | revert | 回滚代码 | ❌ revert: 回滚用户认证功能 |
| 🎨 | design | UI/UX 设计更新 | 🎨 design: 更新主页布局 |

## Commit Message 格式

```
<type>(<scope>): <description>

[body]

[footer]
```

### type 类型
- feat: 新功能
- fix: 修复
- docs: 文档
- style: 格式
- refactor: 重构
- test: 测试
- chore: 构建或辅助工具变动

### scope 范围（可选）
用于说明 commit 影响的范围，如：
- auth: 认证相关
- ui: 界面相关
- api: 接口相关
- db: 数据库相关
- utils: 工具函数

### description 描述
- 简短描述，不超过 50 字符
- 使用现在时态
- 首字母小写
- 结尾不加句号

### body 内容
- 详细说明变更内容
- 说明变更原因和影响
- 可以使用多行
- 建议每行 72 字符

### footer
- 用于记录 Breaking Changes 或 Closed Issues

## 示例

### 功能添加
```
✅ feat(auth): 添加用户注册功能

- 实现邮箱验证流程
- 添加密码强度检查
- 支持第三方登录

Closes #123
```

### Bug 修复
```
🐛 fix(ui): 修复响应式布局问题

- 修复移动端导航栏显示异常
- 优化表格在小屏幕上的表现
```

### 文档更新
```
📚 docs: 更新 README 文档

- 添加安装说明
- 更新使用示例
- 补充 API 文档链接
```

### 代码重构
```
🧹 refactor(utils): 优化工具函数

- 合并重复代码
- 提取公共方法
- 提高代码可读性
```

## 注意事项

1. 使用 emoji 作为前缀，提高可读性
2. 保持 commit message 简洁明了
3. 一个 commit 只做一件事
4. 提交前检查代码格式
5. 避免提交敏感信息