4 min
为什么使用 Emoji?
使用 Emoji 标记提交信息有以下优势:
- 视觉直观 - 一眼就能识别提交类型
- 提高效率 - 快速理解项目历史
- 标准化 - 团队协作时保持一致性
- 趣味性 - 让枯燥的提交记录变得生动
常用 Emoji 规范
核心功能类
| Emoji | 代码 | 说明 | 示例 |
|---|
| ✨ | :sparkles: | 引入新功能 | ✨ 添加用户登录功能 |
| 🐛 | :bug: | 修复 bug | 🐛 修复导航栏在移动端显示异常 |
| 🔥 | :fire: | 移除代码或文件 | 🔥 删除废弃的旧版 API |
| ♻️ | :recycle: | 重构代码 | ♻️ 重构用户认证模块 |
| ⚡️ | :zap: | 提升性能 | ⚡️ 优化图片加载速度 |
| 💄 | :lipstick: | 更新 UI 和样式 | 💄 调整按钮样式和颜色 |
文档和配置
| Emoji | 代码 | 说明 | 示例 |
|---|
| 📝 | :memo: | 添加或更新文档 | 📝 更新 API 使用文档 |
| 🎨 | :art: | 改进代码结构/格式 | 🎨 格式化代码并优化导入 |
| 🔧 | :wrench: | 添加或更新配置文件 | 🔧 更新 ESLint 配置 |
| 🌐 | :globe_with_meridians: | 国际化与本地化 | 🌐 添加英文翻译 |
测试相关
| Emoji | 代码 | 说明 | 示例 |
|---|
| ✅ | :white_check_mark: | 添加或更新测试 | ✅ 添加用户注册单元测试 |
| 🧪 | :test_tube: | 添加失败的测试 | 🧪 添加边界条件测试用例 |
| 🤡 | :clown_face: | Mock 数据和测试 | 🤡 添加 API Mock 数据 |
依赖和构建
| Emoji | 代码 | 说明 | 示例 |
|---|
| ⬆️ | :arrow_up: | 升级依赖 | ⬆️ 升级 React 到 v18 |
| ⬇️ | :arrow_down: | 降级依赖 | ⬇️ 降级 Node 版本以修复兼容性 |
| ➕ | :heavy_plus_sign: | 添加依赖 | ➕ 添加 Axios 依赖 |
| ➖ | :heavy_minus_sign: | 移除依赖 | ➖ 移除未使用的 lodash |
| 📦 | :package: | 添加或更新编译文件 | 📦 更新打包配置 |
| 👷 | :construction_worker: | 添加或更新 CI 构建系统 | 👷 添加 GitHub Actions 工作流 |
安全和修复
| Emoji | 代码 | 说明 | 示例 |
|---|
| 🔒 | :lock: | 修复安全问题 | 🔒 修复 XSS 漏洞 |
| 🚨 | :rotating_light: | 修复编译器/linter 警告 | 🚨 修复 TypeScript 类型错误 |
| 🩹 | :adhesive_bandage: | 简单修复非关键问题 | 🩹 修复控制台警告信息 |
| 🚑 | :ambulance: | 重要的热修复 | 🚑 紧急修复生产环境崩溃问题 |
开发过程
| Emoji | 代码 | 说明 | 示例 |
|---|
| 🚧 | :construction: | 工作进行中 | 🚧 实现支付功能(进行中) |
| 💚 | :green_heart: | 修复 CI 构建问题 | 💚 修复 CI 测试失败 |
| 🔖 | :bookmark: | 发行/版本标签 | 🔖 发布 v1.2.0 |
| 🎉 | :tada: | 初始化项目 | 🎉 初始化项目结构 |
| 🗃️ | :card_file_box: | 数据库相关更改 | 🗃️ 添加用户表索引 |
其他常用
| Emoji | 代码 | 说明 | 示例 |
|---|
| 💡 | :bulb: | 添加或更新源代码注释 | 💡 添加复杂算法的注释说明 |
| 🔊 | :loud_sound: | 添加或更新日志 | 🔊 添加详细的错误日志 |
| 🔇 | :mute: | 移除日志 | 🔇 移除调试日志 |
| 🚀 | :rocket: | 部署功能 | 🚀 部署到生产环境 |
| 👽 | :alien: | 由于外部 API 更改而更新代码 | 👽 更新以适配新版 Google Maps API |
| 🍱 | :bento: | 添加或更新资源文件 | 🍱 添加产品图片和图标 |
| ♿️ | :wheelchair: | 改进可访问性 | ♿️ 添加 ARIA 标签提升无障碍性 |
| 🥚 | :egg: | 添加或更新彩蛋 | 🥚 添加 Konami 代码彩蛋 |
| 🙈 | :see_no_evil: | 添加或更新 .gitignore | 🙈 忽略 .env 文件 |
VS Code 插件推荐
- Gitmoji - 提供 emoji 选择器
- Conventional Commits - 规范提交信息格式
- Git Emoji Commit - 快速插入 emoji
参考资源