文字是抽象的,图片是相对具象的;相比文字人总是对图形提供的信息更加敏锐,执行 git commit
时使用 emoji 可以打个标签,使得此次 commit 的主要工作主题得以凸现,也能够使得其在整个提交历史中易于区分与查找,让每一次提交都充满活力 🤘
效果图
![]()
但是 emoji 表情在提交代码的时候也不能乱用,否则容易造成误解。因此开源项目 gitmoji 专门规定了在 GitHub 提交代码时应当遵循的 emoji 规范
commit 格式
git commit
时,提交信息遵循以下格式:
1
| git commit -m ':emoji1: :emoji2: 主题'
|
:emoji1: :emoji2: 不超过 50 个字的摘要,首字母大写,使用祈使语气,句末不要加句号
提交信息主体
引用相关 issue 或 PR 编号 <#110>
初次提交示例:
1
| git commit -m ":tada: Initialize Repo"
|
emoji 说明
emoji |
emoji 代码 |
commit 说明 |
🎉 (庆祝) |
:tada: |
初次提交 |
🐛 (bug) |
:bug: |
修复 bug |
🆕 (全新) |
:new: |
引入新功能 |
🔖 (书签) |
:bookmark: |
发行/版本标签 |
🚑 (急救车) |
:ambulance: |
重要补丁 |
🌐 (地球) |
:globe_with_meridians: |
国际化与本地化 |
💄 (口红) |
:lipstick: |
更新 UI 和样式文件 |
🎬 (场记板) |
:clapper: |
更新演示/示例 |
🚨 (警车灯) |
:rotating_light: |
移除 linter 警告 |
🔧 (扳手) |
:wrench: |
修改配置文件 |
➕ (加号) |
:heavy_plus_sign: |
增加一个依赖 |
➖ (减号) |
:heavy_minus_sign: |
减少一个依赖 |
⬆️ (上升箭头) |
:arrow_up: |
升级依赖 |
⬇️ (下降箭头) |
:arrow_down: |
降级依赖 |
📈 (上升趋势图) |
:chart_with_upwards_trend: |
添加分析或跟踪代码 |
🚀 (火箭) |
:rocket: |
部署功能 |
✅ (白色复选框) |
:white_check_mark: |
增加测试 |
📝 (备忘录) 📖 (书) |
:memo:
:book: |
撰写文档 |
🔨 (锤子) |
:hammer: |
重大重构 |
🎨 (调色板) |
:art: |
改进代码结构/代码格式 |
🔥 (火焰) |
:fire: |
移除代码或文件 |
✏️ (铅笔) |
:pencil2: |
修复 typo |
🚧 (施工) |
:construction: |
工作进行中 |
🗑️ (垃圾桶) |
:wastebasket: |
废弃或删除 |
♿ (轮椅) |
:wheelchair: |
可访问性 |
👷 (工人) |
:construction_worker: |
添加 CI 构建系统 |
💚 (绿心) |
:green_heart: |
修复 CI 构建问题 |
🔒 (锁) |
:lock: |
修复安全问题 |
🐳 (鲸鱼) |
:whale: |
Docker 相关工作 |
🍎 (苹果) |
:apple: |
修复 macOS 下的问题 |
🐧 (企鹅) |
:penguin: |
修复 Linux 下的问题 |
🏁 (旗帜) |
:checkered_flag: |
修复 Windows 下的问题 |
🔀 (交叉箭头) |
:twisted_rightwards_arrows: |
分支合并 |
⚡ (闪电) 🐎 (赛马) |
:zap:
:racehorse: |
提升性能 |
😏 (坏笑) |
:smirk: |
实现的很得意 |
💩 (便便) |
:shit: |
产品经理提的垃圾需求的实现 |
💦 (水滴) |
:sweat_drops: |
打飞机的时候写的代码 |
🙈 (捂眼) |
:see_no_evil: |
不忍直视的实现 |
(章鱼猫) |
:octocat: |
从 github 拷贝的代码 |
💡 (灯泡) |
:bulb: |
灵感突现的实现 |
💰 (钱) |
:moneybag: |
收钱改的需求 |
(暴漫) |
:trollface: |
混提交记录 |
如何在命令行中显示 emoji
默认情况下,在命令行中并不会显示出 emoji,仅显示 emoji 代码。不过可以使用 emojify 使得在命令行也可显示 emoji,它是一个 shell 脚本,安装与使用都很简单,在 这里 查看如何安装与使用。
参考