{"id":13486802,"url":"https://github.com/liuchengxu/git-commit-emoji-cn","last_synced_at":"2025-10-25T04:21:38.510Z","repository":{"id":47573461,"uuid":"74249818","full_name":"liuchengxu/git-commit-emoji-cn","owner":"liuchengxu","description":"😁 git commit message emoji 使用指南","archived":false,"fork":false,"pushed_at":"2021-07-06T01:42:45.000Z","size":285,"stargazers_count":1939,"open_issues_count":6,"forks_count":265,"subscribers_count":20,"default_branch":"master","last_synced_at":"2025-04-08T02:39:18.085Z","etag":null,"topics":["emoji","git"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/liuchengxu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-11-20T03:09:47.000Z","updated_at":"2025-03-30T14:40:36.000Z","dependencies_parsed_at":"2022-09-04T08:01:58.322Z","dependency_job_id":null,"html_url":"https://github.com/liuchengxu/git-commit-emoji-cn","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liuchengxu%2Fgit-commit-emoji-cn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liuchengxu%2Fgit-commit-emoji-cn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liuchengxu%2Fgit-commit-emoji-cn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liuchengxu%2Fgit-commit-emoji-cn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/liuchengxu","download_url":"https://codeload.github.com/liuchengxu/git-commit-emoji-cn/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254414497,"owners_count":22067272,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["emoji","git"],"created_at":"2024-07-31T18:00:51.333Z","updated_at":"2025-10-25T04:21:33.471Z","avatar_url":"https://github.com/liuchengxu.png","language":null,"funding_links":[],"categories":["Others","Others (1002)"],"sub_categories":[],"readme":"git commit emoji 使用指南\n============================\n\n#### 目录\n\n\u003c!-- vim-markdown-toc GFM --\u003e\n\n* [commit 格式](#commit-格式)\n* [emoji 指南](#emoji-指南)\n* [如何在命令行中显示 emoji](#如何在命令行中显示-emoji)\n* [参考](#参考)\n  * [git commit emoji](#git-commit-emoji)\n  * [write a good commit message](#write-a-good-commit-message)\n\n\u003c!-- vim-markdown-toc --\u003e\n\n执行 `git commit` 时使用 emoji 为本次提交打上一个 \"标签\", 使得此次 commit 的主要工作得以凸现，也能够使得其在整个提交历史中易于区分与查找。\n\n截取的 [gitmoji](https://github.com/carloscuesta/gitmoji) 快照:\n\n![gitmoji-snapshot](snapshot.png)\n\n### commit 格式\n\n`git commit` 时，提交信息遵循以下格式：\n\n```sh\n:emoji1: :emoji2: 不超过 50 个字的摘要，首字母大写，使用祈使语气，句末不要加句号\n\n提交信息主体\n\n引用相关 issue 或 PR 编号 \u003c#110\u003e\n```\n\n初次提交示例：\n\n```sh\ngit commit -m \":tada: Initialize Repo\"\n```\n\n### emoji 指南\n\nemoji                                   | emoji 代码                   | commit 说明\n:--------                               | :--------                    | :--------\n:tada: (庆祝)                           | `:tada:`                     | 初次提交\n:new: (全新)                            | `:new:`                      | 引入新功能\n:bookmark: (书签)                       | `:bookmark:`                 | 发行/版本标签\n:bug: (bug)                             | `:bug:`                      | 修复 bug\n:ambulance: (急救车)                    | `:ambulance:`                | 重要补丁\n:globe_with_meridians: (地球)           | `:globe_with_meridians:`     | 国际化与本地化\n:lipstick: (口红)                       | `:lipstick:`                 | 更新 UI 和样式文件\n:clapper: (场记板)                      | `:clapper:`                  | 更新演示/示例\n:rotating_light: (警车灯)               | `:rotating_light:`           | 移除 linter 警告\n:wrench: (扳手)                         | `:wrench:`                   | 修改配置文件\n:heavy_plus_sign: (加号)                | `:heavy_plus_sign:`          | 增加一个依赖\n:heavy_minus_sign: (减号)               | `:heavy_minus_sign:`         | 减少一个依赖\n:arrow_up: (上升箭头)                   | `:arrow_up:`                 | 升级依赖\n:arrow_down: (下降箭头)                 | `:arrow_down:`               | 降级依赖\n:zap: (闪电)\u003cbr\u003e:racehorse: (赛马)      | `:zap:`\u003cbr\u003e`:racehorse:`      | 提升性能\n:chart_with_upwards_trend: (上升趋势图) | `:chart_with_upwards_trend:` | 添加分析或跟踪代码\n:rocket: (火箭)                         | `:rocket:`                   | 部署功能\n:white_check_mark: (白色复选框)         | `:white_check_mark:`           | 增加测试\n:memo: (备忘录)\u003cbr\u003e:book: (书)          | `:memo:`\u003cbr\u003e`:book:`          | 撰写文档\n:hammer: (锤子)                         | `:hammer:`                   | 重大重构\n:art: (调色板)                          | `:art:`                      | 改进代码结构/代码格式\n:fire: (火焰)                           | `:fire:`                     | 移除代码或文件\n:pencil2: (铅笔)                        | `:pencil2:`                  | 修复 typo\n:construction: (施工)                   | `:construction:`             | 工作进行中\n:wastebasket: (垃圾桶)                  | `:wastebasket:`              | 废弃或删除\n:wheelchair: (轮椅)                     | `:wheelchair:`               | 可访问性\n:construction_worker: (工人)            | `:construction_worker:`      | 添加 CI 构建系统\n:green_heart: (绿心)                    | `:green_heart:`              | 修复 CI 构建问题\n:lock: (锁)                             | `:lock:`                     | 修复安全问题\n:whale: (鲸鱼)                          | `:whale:`                    | Docker 相关工作\n:apple: (苹果)                          | `:apple:`                    | 修复 macOS 下的问题\n:penguin: (企鹅)                        | `:penguin:`                  | 修复 Linux 下的问题\n:checkered_flag: (旗帜)                 | `:checkered_flag:`           | 修复 Windows 下的问题\n:twisted_rightwards_arrows: (交叉箭头)   | `:twisted_rightwards_arrows:`| 分支合并\n\n\n\n### 如何在命令行中显示 emoji\n\n默认情况下，在命令行中并不会显示出 emoji, 仅显示 emoji 代码。不过可以使用 [emojify](https://github.com/mrowa44/emojify) 使得在命令行也可显示 emoji, 它是一个 shell 脚本，安装与使用都很简单，在 [这里](https://github.com/mrowa44/emojify) 查看如何安装与使用。\n\n![emojify](terminal_emojify.png)\n\n### 参考\n\n#### git commit emoji\n\n- [gitmoji](https://github.com/carloscuesta/gitmoji/)\n- [emoji-cheat-sheet](http://www.webpagefx.com/tools/emoji-cheat-sheet/)\n- [styleguide-git-commit-message](https://github.com/slashsBin/styleguide-git-commit-message)\n- [atom git commit messages guide](https://github.com/atom/atom/blob/master/CONTRIBUTING.md#git-commit-messages)\n- [An emoji guide for your commit messages](https://gitmoji.carloscuesta.me/)\n- [程序员提交代码的 emoji 指南——原来表情文字不能乱用](https://www.h5jun.com/post/gitmoji.html)\n- [Ant Design 更新日志 emoji 规范](https://github.com/ant-design/ant-design/wiki/%E8%BD%AE%E5%80%BC%E8%A7%84%E5%88%99%E5%92%8C%E7%89%88%E6%9C%AC%E5%8F%91%E5%B8%83%E6%B5%81%E7%A8%8B#emoji-for-changelog)\n\n#### write a good commit message\n\n- [A Note About Git Commit Messages](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html)\n- [How to write a Git Commit Message (2014)](https://news.ycombinator.com/item?id=13889155)\n- [how to write a good git commit message](https://github.com/joelparkerhenderson/git_commit_message)\n- [5 Useful Tips For A Better Commit Message](https://robots.thoughtbot.com/5-useful-tips-for-a-better-commit-message)\n- [Udacity Git Commit Message Style Guide](http://udacity.github.io/git-styleguide/)\n- [How to commit a change with both “message” and “description” from the command line?](https://stackoverflow.com/questions/16122234/how-to-commit-a-change-with-both-message-and-description-from-the-command-li)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliuchengxu%2Fgit-commit-emoji-cn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fliuchengxu%2Fgit-commit-emoji-cn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliuchengxu%2Fgit-commit-emoji-cn/lists"}