如何写出干净的 Git Commit

大家好,我是楷鹏。

写一份干净的 Git Commit,不仅赏心悦目,也有诸多好处,比如

  1. 为项目或者仓库生成 change log
  2. 方便在其他一些 Git 工具使用,比如 CI/CD、代码协作和审计平台、发版工具

这是 AngularJS 仓库的 Git Commit,干净,简洁,统一

↪️ github.com/angular/ang...

AngularJS 对 Git Commit 做了规范,值得借鉴。

Commit 组成:

xml 复制代码
<header>
<空一行>
<body>
<空一行>
<footer>

🌰 举例:

对应如下:

其中

  • header 是必要的
  • body 也是必要的,除了类型为 docs 之外,body 的内容必须大于 20 个字符
  • footer 是可选的,比如放置引用的 issue

header 由三部分组成:

sql 复制代码
<类型>(<作用域>): <主题>
  │       │             │
  │       │             └─⫸ 简短总结,现在时态,不需要首字母大写,末尾不用加句号
  │       │
  │       └─⫸ Commit 作用域: animations|bazel|benchpress|common|compiler|compiler-cli|core|
  │                          elements|forms|http|language-service|localize|platform-browser|
  │                          platform-browser-dynamic|platform-server|router|service-worker|
  │                          upgrade|zone.js|packaging|changelog|docs-infra|migrations|
  │                          devtools
  │
  └─⫸ Commit 类型: build|ci|docs|feat|fix|perf|refactor|test

类型一共有 8 种:

类型 描述
build 影响构建系统或外部依赖的更改 (示例范围:gulp, broccoli, npm)
ci 对 CI 配置文件和脚本的更改 (示例:CircleCi, SauceLabs, GitHub Workflow)
docs 仅文档更改
feat 新功能
fix 错误修复
perf 改善性能的代码更改
refactor 既不修复错误也不添加功能的代码更改
test 添加缺失测试或更正现有测试

作用域根据工程团队自己定义,可参考 AngularJS 定义的作用域列表:

↪️ github.com/angular/ang...

主题要简单总结,如果团队使用英语,语法上需符合:

  • 祈使句,并且是现在时态,比如 "change",而不是 "changed" 或者 "changes"
  • 首字母不需要大写
  • 结尾不需要逗号或者句号

🌰 举例

csharp 复制代码
docs(server): add javadoc comments on methods
csharp 复制代码
feat(core): add new command 'Upload' to UI
sql 复制代码
fix: update GET headers (#142)

Reference

medium.com/@menuka/wri...


One more thing:

json 复制代码
{
  "公众号": "程序员楷鹏",
  "简介": "世界有 10 种人,一种是懂二进制的,另外一种是不懂的",
  "还有": "你肯定会关注的对吧彦祖?"
}
相关推荐
油泼辣子多加12 分钟前
[特殊字符] GitHub 热门开源项目速览(2025/09/09)
github
柯南二号41 分钟前
【Gitlab】Ubuntu 20.04服务器部署Gitlab
git·gitlab
CoderJia程序员甲1 小时前
GitHub 热榜项目 - 日榜(2025-09-09)
ai·开源·大模型·github·ai教程
phac1231 小时前
git 如何直接拉去远程仓库的内容且忽略本地与远端不一致的commit
大数据·git·elasticsearch
BillKu2 小时前
下载 Eclipse Temurin 的 OpenJDK 提示 “无法访问此网站 github.com 的响应时间过长”
github·openjdk·eclipse temurin
绝无仅有2 小时前
HTTP面试之实战经验与总结
后端·面试·github
绝无仅有2 小时前
职场面试redis经历之与一位资深技术面试官的技术问答与总结
后端·面试·github
老马啸西风7 小时前
v0.29.2 敏感词性能优化之基本类型拆箱、装箱的进一步优化的尝试
性能优化·开源·nlp·github·敏感词
伴杯猫10 小时前
【ESP32-IDF】基础外设开发2:系统中断矩阵
c语言·单片机·嵌入式硬件·mcu·物联网·github
程序视点12 小时前
GitHub Copilot代码审查大升级!路径级指令+组织级规范,开发者效率再提升!
github·github copilot