大家好,我是楷鹏。
写一份干净的 Git Commit,不仅赏心悦目,也有诸多好处,比如
- 为项目或者仓库生成 change log
- 方便在其他一些 Git 工具使用,比如 CI/CD、代码协作和审计平台、发版工具等
这是 AngularJS 仓库的 Git Commit,干净,简洁,统一:
↪️ https://github.com/angular/angular/commits/main
AngularJS 对 Git Commit 做了规范,值得借鉴。
Commit 组成:
<header>
<空一行>
<body>
<空一行>
<footer>
🌰 举例:
对应如下:
其中
- header 是必要的
- body 也是必要的,除了类型为 docs 之外,body 的内容必须大于 20 个字符
- footer 是可选的,比如放置引用的 issue
header 由三部分组成:
<类型>(<作用域>): <主题>
│ │ │
│ │ └─⫸ 简短总结,现在时态,不需要首字母大写,末尾不用加句号
│ │
│ └─⫸ 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 定义的作用域列表:
↪️ https://github.com/angular/angular/blob/main/CONTRIBUTING.md#scope
主题要简单总结,如果团队使用英语,语法上需符合:
- 祈使句,并且是现在时态,比如 “change”,而不是 “changed” 或者 “changes”
- 首字母不需要大写
- 结尾不需要逗号或者句号
🌰 举例
docs(server): add javadoc comments on methods
feat(core): add new command 'Upload' to UI
fix: update GET headers (#142)
Reference
https://medium.com/@menuka/writing-meaningful-git-commit-messages-a62756b65c81
One more thing:
{
"公众号": "程序员楷鹏",
"简介": "世界有 10 种人,一种是懂二进制的,另外一种是不懂的",
"还有": "你肯定会关注的对吧彦祖?"
}