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
网友评论