🔨 [git]:使用 Gitmoji 编写更好的提交
📝 注释
Gitmoji 是一项旨在标准化和解释 GitHub 提交消息中表情符号使用的计划。
📝 简介:如何编写 Git 提交消息
就我而言,只有当我想追踪提交的变更或挖掘提交说明时,我才会阅读提交内容。否则,我会直接阅读源代码。
下面是一个良好的 git 提交消息语义的示例(根据Gist Semantic Commit Messages)
<type> [scope]: "Message"
类型必须是下列之一:
- <build>:构建相关更改(例如:npm 相关/添加外部依赖项)
- <chore>:外部用户看不到的代码更改(例如:更改为 .gitignore)
- <docs>:文档相关的更改
- <feat>:引入新功能
- <fix>:解决与开发直接相关的问题(错误修复)
- <hotfix>:解决与生产直接相关的问题(补丁)
- <test>:添加/更新测试用例
- <performance>:添加提高性能的代码
- <refactor>:更新代码以提高可维护性(干净的代码)
范围是可选的,并且必须是表示代码库部分的名词
消息应该是必要的,并且应该用清晰的信息/关键字描述提交。
提交示例:
feat(home, components): Add login button
feat(home, components): Add login modal
fix(home, components): Resolve issue with modal collapses
chore(home): Move icons folder
feat(newsletter): Add Newsletter component
feat(navbar): Add navbar container
🚀 吉莫吉
在提交信息中使用表情符号,只需查看所使用的表情符号,就能轻松识别提交的目的或意图。由于表情符号种类繁多,我发现有必要创建一个指南,帮助大家更轻松地使用表情符号。
现在我们可以用表情符号替换 <type/> :
🎨 改进代码的结构/格式。
⚡️提高性能。
🔥 删除代码或文件。
🐛 修复一个错误。
✨ 介绍新功能。
📝 添加或更新文档。
🚀 部署东西。
💚 修复 CI 构建。
👷 添加或更新 CI 构建系统。
🔧 添加或更新配置文件。
🔨 添加或更新开发脚本。
⚰️ 删除无效代码。
提交示例:
✨ (home, components): Add login button
✨ (home, components): Add login modal
🐛 (home, components): Resolve issue with modal collapses
🚚 (home): Move icons folder
✨ (newsletter): Add Newsletter component
✨ (navbar): Add navbar container
🔥 (navbar): Remove old navbar file
✅ (home): Add login test case
🎨 (home, component): Improve login modal
📦️ (npm): Add react-table
🔨 Update script start-server.js
附加图标
🐳 Add Dockerfile
🐳 Add docker-compose.yml
☸️ (helm): Add postgres helm chart
☸️ (helm): Update frontend.yaml
☸️ (helm): Update pvc.yaml
🐎 (home): Increase speed load for navbar
🍎 (home): Fix issue with MacOS for navbar
链接:EmojiPedia
📦️ Gitmoji-CLI
用于在提交消息上使用 gitmojis 的 gitmoji 交互式客户端。
安装
使用 npm :
npm install gitmoji-cli
在 MacOS 上:
brew install gitmoji
交互式客户端
启动交互式提交客户端,根据您的提示自动生成您的提交。
gitmoji -c
钩
运行 init 选项,添加您的更改并提交它们,之后提示将开始,并且您的提交消息将被构建。
gitmoji -i
git add .
git commit
搜索
使用特定关键字搜索以找到正确的 gitmoji。
gitmoji -s "criteria"
列表
漂亮地打印所有可用的 gitmojis。
gitmoji -l
配置
运行 gitmoji -g 来设置一些 gitmoji-cli 首选项。
gitmoji config
🔨扩展(与 IDE 集成)
适用于 Vscode 的 Gitmoji
链接:https://marketplace.visualstudio.com/items?itemName =Vtrois.gitmoji-vscode
Atom 版 Gitmoji
转到设置(cmd + ,或 ctrl + ,)> 安装并搜索 gitmoji-atom。
或者,运行以下命令:
apm install gitmoji-atom
链接:https://atom.io/packages/gitmoji-atom
💻 与 DEV.TO 集成?
您认为我们可以在为 Dev.TO 撰写帖子时使用它吗?
🐳 Docker
☸️ Kubernetes
...
链接
-
https://gist.github.com/joshbuchea/6f47e86d2510bce28f8e7f42ae84c716
-
https://gist.github.com/robertpainsi/b632364184e70900af4ab688decf6f53
-
https://dev.to/i5han3/git-commit-message-convention-that-you-can-follow-1709
-
https://dev.to/helderburato/patterns-for-writing-better-git-commit-messages-4ba0