编程界常用Emoji 速查手册
本手册整理编程全场景高频使用的Emoji，覆盖Git提交、文档编写、团队协作、代码注释、项目管理等核心场景，兼容GitHub/GitLab/Gitee等主流平台，可直接复制使用。
一、Git 提交核心规范Emoji（Gitmoji 标准）
这是开发中最常用的分类，用于commit提交信息，直观标识本次提交的核心意图，提升日志可读性与检索效率。
| Emoji | 短代码 | 核心含义 | 典型使用场景 |
|---|---|---|---|
| 🎨 | :art: | 代码结构/格式优化 | 改进代码格式、重构代码逻辑、优化代码可读性，不改变代码功能 |
| ⚡ | :zap: | 性能优化 | 提升代码运行速度、接口响应、加载性能等优化操作 |
| 🔥 | :fire: | 移除代码/文件 | 删除废弃代码、无用文件、过期功能模块 |
| 🐛 | :bug: | 修复Bug | 修复线上/测试环境的功能缺陷、逻辑错误 |
| 🚑 | :ambulance: | 紧急修复 | 线上故障、生产环境的紧急热修复 |
| ✨ | :sparkles: | 新增功能 | 开发新特性、新增业务功能、模块能力扩展 |
| 📝 | :memo: | 文档更新 | 新增/修改README、接口文档、使用说明、注释文档 |
| 🚀 | :rocket: | 部署/发布 | 项目版本发布、生产环境/测试环境部署操作 |
| 💄 | :lipstick: | UI/样式更新 | 前端样式、UI界面、交互效果的调整与优化 |
| 🎉 | :tada: | 项目初始化 | 项目首次提交、仓库初始化、里程碑版本发布 |
| ✅ | :white_check_mark: | 测试相关 | 新增/修改单元测试、集成测试、自动化用例 |
| 🔒 | :lock: | 安全相关 | 修复安全漏洞、加密逻辑优化、权限控制调整 |
| 🔐 | :closed_lock_with_key: | 密钥/凭证相关 | 新增/更新密钥、凭证、证书相关内容 |
| 🔖 | :bookmark: | 版本标签 | 发布版本Tag、版本号更新 |
| 🚨 | :rotating_light: | 修复告警/规范 | 解决ESLint/TS语法告警、编译警告、代码规范问题 |
| 🚧 | :construction: | 开发中/WIP | 功能开发中、未完成的临时提交、Work In Progress |
| 💚 | :green_heart: | 修复CI/CD | 解决持续集成/流水线构建失败问题 |
| ⬇️ | :arrow_down: | 依赖降级 | 降级第三方依赖、库版本回退 |
| ⬆️ | :arrow_up: | 依赖升级 | 升级第三方依赖、框架、工具包版本 |
| 📌 | :pushpin: | 依赖版本固定 | 锁定依赖包版本、固定环境版本号 |
| 👷 | :construction_worker: | CI/CD 配置更新 | 新增/修改流水线、构建脚本、Docker配置 |
| 📈 | :chart_with_upwards_trend: | 监控/埋点 | 新增业务监控、数据埋点、统计分析代码 |
| ♻️ | :recycle: | 代码重构 | 代码大版本重构、逻辑拆分，不改变原有功能 |
| ➕ | :heavy_plus_sign: | 新增依赖 | 新增第三方依赖、库、插件引入 |
| ➖ | :heavy_minus_sign: | 移除依赖 | 移除第三方依赖、库、插件 |
| 🔧 | :wrench: | 配置文件修改 | 调整项目配置、环境配置、工具配置 |
| 🔨 | :hammer: | 构建脚本/工具修改 | 优化构建流程、开发工具、辅助脚本 |
| 🌐 | :globe_with_meridians: | 国际化/多语言 | 新增/修改多语言文案、国际化适配 |
| ✏️ | :pencil2: | 修复错别字/Typo | 修正文案、注释、代码中的拼写错误 |
| 💩 | :poop: | 待优化的坏代码 | 临时实现的坏代码、需要后续重构的逻辑 |
| ⏪ | :rewind: | 代码回滚 | 版本回滚、提交记录回退 |
| 🔀 | :twisted_rightwards_arrows: | 分支合并 | 合并分支、PR合入、代码冲突解决 |
| 📦 | :package: | 打包/制品更新 | 调整打包配置、更新制品库、npm包发布 |
| 👽 | :alien: | 外部API变更适配 | 因第三方接口变更修改代码、兼容外部系统调整 |
| 🚚 | :truck: | 文件/路径移动 | 移动代码文件、目录结构调整、资源路径修改 |
| 📄 | :page_facing_up: | 许可证/协议更新 | 新增/修改开源协议、许可证文件 |
| 💥 | :boom: | 破坏性变更 | 不兼容的版本变更、API大版本调整、破坏性更新 |
| 🍱 | :bento: | 资源文件更新 | 新增/修改静态资源、图片、图标、音频等文件 |
| ♿ | :wheelchair: | 无障碍适配 | 无障碍功能优化、兼容性适配 |
| 💡 | :bulb: | 注释/示例补充 | 新增代码注释、示例代码、文档说明补充 |
| 🍻 | :beers: | 协同开发代码 | 结对编程、多人协同开发的提交 |
| 🗃️ | :card_file_box: | 数据库变更 | 表结构修改、SQL脚本更新、数据库迁移 |
| 👥 | :busts_in_silhouette: | 贡献者/协作信息更新 | 新增贡献者、修改协作人员信息 |
| 🚸 | :children_crossing: | 用户体验优化 | 交互体验、易用性优化、新手引导调整 |
| 🏗️ | :building_construction: | 架构调整 | 项目架构大版本变更、技术栈调整 |
| 📱 | :iphone: | 移动端适配 | 移动端兼容性、响应式适配、H5优化 |
| 🤡 | :clown_face: | Mock相关 | 新增/修改Mock数据、测试桩、模拟接口 |
| 🥚 | :egg: | 新增彩蛋 | 新增彩蛋功能、隐藏玩法 |
二、文档与笔记常用Emoji
用于README、技术文档、学习笔记、知识库编写，提升文档层级感与可读性。
| Emoji | 短代码 | 核心含义 | 典型使用场景 |
|---|---|---|---|
| 📚 | :books: | 参考资料/文献 | 文档参考链接、相关资料、推荐阅读 |
| 📌 | :pushpin: | 重点内容/置顶 | 核心要点、重点提示、置顶说明 |
| ⚠️ | :warning: | 警告/注意事项 | 风险提示、踩坑说明、需要特别注意的内容 |
| ℹ️ | :information_source: | 提示/说明信息 | 补充说明、背景介绍、基础信息 |
| ❗ | :exclamation: | 重要提醒 | 必须关注的内容、强提醒 |
| ❓ | :question: | 疑问/FAQ | 常见问题、待确认内容、疑问点 |
| ✅ | :white_check_mark: | 已完成/已支持 | 已实现功能、已完成事项、支持的特性 |
| ❌ | :x: | 未完成/不支持 | 未实现功能、不支持的特性、禁用事项 |
| 🔗 | :link: | 链接/引用 | 外部链接、参考文档、跳转地址 |
| 📖 | :book: | 教程/文档 | 详细教程、使用手册、完整文档 |
| 🎯 | :dart: | 目标/核心目的 | 项目目标、文档核心目的、核心需求 |
| 🧩 | :jigsaw: | 模块/组件 | 功能模块、组件介绍、插件说明 |
| 🛠️ | :hammer_and_wrench: | 开发工具/环境 | 开发环境搭建、工具安装、环境配置 |
| 🪜 | :ladder: | 步骤/流程 | 分步教程、操作流程、执行步骤 |
| 📊 | :bar_chart: | 数据/统计 | 性能数据、统计结果、指标展示 |
三、Issue/PR 团队协作常用Emoji
用于GitHub/GitLab等平台的Issue、PR、工单管理，快速标识任务状态与类型。
| Emoji | 短代码 | 核心含义 | 典型使用场景 |
|---|---|---|---|
| 🐛 | :bug: | Bug反馈 | 提交缺陷、Bug反馈工单 |
| ✨ | :sparkles: | 功能需求 | 新功能提议、需求建议 |
| 📝 | :memo: | 文档相关 | 文档修改、内容纠错、补充建议 |
| 🤔 | :thinking: | 待讨论/疑问 | 需要讨论的内容、方案疑问、需求确认 |
| 👀 | :eyes: | 待评审/待查看 | 需要Code Review、需要查看确认 |
| 👍 | :+1: | 同意/通过 | 同意方案、评审通过、认可建议 |
| 👎 | :-1: | 反对/不认可 | 反对方案、不认可改动 |
| 🙏 | :pray: | 求助/请求 | 请求帮助、请求合入、请求评审 |
| 🚧 | :construction: | 开发中 | 功能开发中、PR未完成、暂不合入 |
| 🏁 | :checkered_flag: | 已完成 | 需求已实现、Bug已修复、工单已完结 |
| 🚫 | :no_entry_sign: | 拒绝/关闭 | 拒绝合入、关闭工单、不采纳建议 |
| ⏳ | :hourglass_flowing_sand: | 处理中 | 正在处理、修复中、排期中 |
| 🎉 | :tada: | 已上线/已发布 | 功能已上线、版本已发布 |
| 📌 | :pushpin: | 置顶/长期关注 | 置顶Issue、长期维护的任务 |
四、代码注释与调试常用Emoji
用于代码内注释，快速标识注释类型，提升代码可维护性。
| Emoji | 核心含义 | 注释示例 |
|---|---|---|
| TODO | 待办事项 | // TODO: 这里需要补充异常处理逻辑 |
| FIXME | 待修复的问题 | // FIXME: 边界条件下会出现数组越界，需要修复 |
| BUG | 已知Bug | // BUG: 高并发场景下会出现数据重复，待优化 |
| HACK | 临时hack方案 | // HACK: 临时兼容旧版本接口，后续重构需要移除 |
| NOTE | 说明/备注 | // NOTE: 这里使用单例模式，避免重复创建实例 |
| OPTIMIZE | 待优化点 | // OPTIMIZE: 循环内频繁查询数据库，可批量查询优化 |
| WARN | 风险警告 | // WARN: 这里修改会影响下游接口，改动前需要全量回归 |
| IDEA | 优化思路 | // IDEA: 后续可以用缓存来降低数据库查询压力 |
五、项目管理与进度常用Emoji
用于项目排期、任务看板、进度跟踪，直观标识任务状态。
| Emoji | 短代码 | 核心含义 | 典型使用场景 |
|---|---|---|---|
| 📅 | :date: | 排期/截止日期 | 任务截止时间、版本发布日期、里程碑节点 |
| 🎯 | :dart: | 里程碑/核心目标 | 项目里程碑、版本核心目标、重点任务 |
| 📋 | :clipboard: | 任务清单/计划 | 迭代任务清单、项目计划、待办列表 |
| ⏳ | :hourglass_flowing_sand: | 进行中 | 正在开发的任务、进行中的迭代 |
| ✅ | :white_check_mark: | 已完成 | 已完结的任务、已上线的功能 |
| 🚫 | :no_entry_sign: | 已取消 | 已取消的需求、作废的任务 |
| 📤 | :outbox_tray: | 待提测 | 开发完成、待提交测试的任务 |
| 🧪 | :test_tube: | 测试中 | 正在测试、测试验证中的任务 |
| 🚀 | :rocket: | 待发布 | 测试通过、待上线发布的任务 |
| 🎉 | :tada: | 已上线 | 已发布上线、已交付的任务 |
| 🐛 | :bug: | 缺陷修复 | 线上Bug修复、问题整改任务 |
| 📚 | :books: | 文档任务 | 文档编写、手册更新、培训材料任务 |
六、使用规范与建议
- 语义优先，宁缺毋滥：优先保证Emoji语义准确，避免过度使用，单条提交/标题建议不超过2个Emoji。
- 团队统一规范：团队内使用前统一约定Emoji的使用规则，避免同一场景多个Emoji混用。
- 兼容场景适配：旧终端、日志系统、部分自动化工具可能对Emoji兼容性不佳，可搭配
[fix][feat]等文本标签双重标识。 - 编码规范：项目文件统一使用UTF-8编码，避免Emoji出现乱码问题。
- 参考标准：工业界通用标准可参考 Gitmoji 官方规范，可搭配工具实现提交时自动校验与补全。