Git 提交规范
制定一个 git commit 信息的提交规范是开发团队工作流必不可少的环节。试想一下,如果查看主分支上的历史库也就是你查看 git log 的时候,打印出来的信息杂乱无章的话,如果代码遇到问题,可能需要很大的精力与成本来查找到导致问题的代码提交,所以团队需要制定规范来引导成员编写规范的 commit 信息。
接下来的 commit 信息规范参考了 angularjs 团队的开发者指引与笔者的工作团队进行总结,读者如有需要可以以此为基础增加或修改成为自己团队的 commit 规范的一部分。
提交信息基本模板
如果 commit 信息都按照一定的模式进行提交,那么我们就会很容易找到自己想要的信息,模板参考如下:
<type>(<scope>): <subject> [<ISSUE_ID>]
<body>
<footer>
commit 信息包括三个字段: type (必需), scope(可选) 和 subject(必需):
- type。type 是用于说明该 commit 的类型的,一般我们会规定 type 的类型如下:
- feat: 新功能(feature)
- fix: 修复 bug
- docs: 文档(documents)
- style: 代码格式(不影响代码运行的格式变动,注意不是指 CSS 的修改)
- refactor: 重构(既不是新增功能,也不是修改 bug 的代码变动)
- test: 提交测试代码(单元测试,集成测试等)
- chore: 构建或辅助工具的变动
- misc: 一些未归类或不知道将它归类到什么方面的提交
scope。scope 说明 commit 影响的范围,比如数据层,控制层,视图层等等,这个需要视具体场景与项目的不同而灵活变动
subject。subject 是对于该 commit 目的的简短描述
- 使用第一人称现在时的动词开头,比如 modify 而不是 modified 或 modifies
- 首字母小写,并且结尾不加句号
- ISSUEE_ID。这个与公司的需求管理与项目管理有关,假设你的项目放在 github 上,你的需求或者 bug 修复可能会有对应的 issues 记录,你可以加到你的 commit 信息中如 issue-37938634。
body 其实就是 subject 的详细说明,而 footer 中你可以填写相关的需求管理 issues id。
参考:
[1] https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#-git-commit-guidelines