Git Commit 规范参考
引子
在 上逛逛就可以发现，其提交的 都有一定格式，工作中也有相应的规定，时间长了就能体会到其中的好处。这种约束是一种良好的实践。抽出一些时间，更详细的了解相关的资料，然后做了一些实践和总结。
规范 的好处 提供更明确的历史信息，方便判断提交目的和浏览可以过滤某些不必要的提交，方便快速查找信息自动化生成 向同事、公众与其他利益关系人传达变化的性质基于提交的类型，自动决定语义化的版本变更
以上的好处，个人认为要有一个大的前提，就是每一个提交，尽量保证其目的单一性，比如说几个 bug 看似类似，就一次性修改提交。这样做，让 的信息变的复杂化，阅读不方便，也容易让人想到一些不必要的关联性。
的格式
找了几个 start 较多的库，看看提交的格式。
react-
vuejs-
-
网上推荐的写法是第 2 和 3 种，也就是 规范，并有配套的工具。有一个文档对 的格式要求有个描述叫约定式提交。下面就根据 规范和对应文档，看看详细的说明。
每个 包含一个 ，body 和 。 有一个特殊的格式包含有 type，scope 和 ：
():
、body、 之间都要空一行， 是必填项，scope 是选填项。 的每一行的文字不能超过 100 个字符。这样子在 和 git 工具上更便于阅读。
Type
type 用于说明 的类别，必须为以下类型的一种：
Scope
scope 用于说明 影响的范围，当影响的范围有多个时候，可以使用 *。
用于对 变化的简洁描述：
Body
body 用于对 详细描述。使用祈使句，一般以动词原形开始，例如使用 而不是 或者 。
body 应该包含这次变化的动机以及与之前行为的对比。
目前用于两种情况。
1 不兼容的变动
所有不兼容的变动都必须在 区域进行说明，以 : 开头，后面的是对变动的描述，变动的理由和迁移注释。
BREAKING CHANGE: isolate scope bindings definition has changed andthe inject option for the directive controller injection was removed.To migrate the code follow the example below:Before:scope: {myAttr: 'attribute',myBind: 'bind',myExpression: 'expression',myEval: 'evaluate',myAccessor: 'accessor'}After:scope: {myAttr: '@',myBind: '@',myExpression: '&',// myEval - usually not useful, but in cases where the expression is assignable, you can use '='myAccessor: '=' // in directive's template change myAccessor() to myAccessor}The removed `inject` wasn't generaly useful for directives so there should be no code using it.2 关闭 issue
如果 是针对某个 issue，可以在 关闭这个 issue。
## 关闭单个
Closes #234
## 关闭多个
Closes #123, #245, #992
如果 用于撤销之前的 ，这个 就应该以 : 开头，后面是撤销这个 的 。在 body 里面应该写 This .，其中的 hash 是被撤销 的 SHA 标识符。
revert: feat(pencil): add 'graphiteWidth' optionThis reverts commit 667ecc1654a317a13331b17617d973392f415f02.
feat($browser): onUrlChange event (popstate/hashchange/polling)Added new event to $browser:
- forward popstate event if available
- forward hashchange event if popstate not available
- do polling when neither popstate nor hashchange availableBreaks $browser.onHashChange, which was removed (use onUrlChange instead)
fix($compile): couple of unit tests for IE9Older IEs serialize html uppercased, but IE9 does not
Would be better to expect case insensitive, unfortunately jasmine does
not allow to user regexps for throw expectations.Closes #351
style($location): add couple of missing semi colons
docs(guide): updated fixed docs from Google DocsCouple of typos fixed:
- indentation
- batchLogbatchLog -> batchLog
- start periodic checking
- missing brace相关的工具 填写提示工具
这个工具是用来给 一个引导的作用，根据提示一步一步的完善 。
在 环境下安装，个人遇到的问题有：
1、安装 后，进行初始化，找不到命令
尝试成功的解决方法是用 yarn 执行指令:
yarn commitizen init cz-conventional-changelog --save-dev --save-exact
2、按照说明里面直接执行 npx git-cz无效，安装了 npx 也无效
发现在 \bin\ 目录下，并没有 npx 相关可执行文件，需要安装 npx。
安装后还是无效，需要用 yarn 来执行指令
yarn npx git-cz
可以发现执行指令后，显示了对应的可执行文件的路径。
如果配置了 ，那么提交的时候需要执行对应的指令，才会触发这个工具的作用。
还有操作的问题，在自己的戴尔笔记本用上下键切换无效，也尝试过各种组合键，也是无效，外接的键盘有效。
格式校验工具
原 --msg 已不被推荐使用。安装对应要使用的提交规范，
#it also works for Windows
yarn add @commitlint/{config-conventional,cli} --dev# Configure commitlint to use angular config
echo "module.exports = {extends: ['@commitlint/config-conventional']}" > commitlint.config.js
示例用的是 - 规范，这个安装后，还需要使用 hook，推荐使用 husky。安装husky
yarn add husky --dev
然后配置 .json
{"scripts": {"commitmsg": "commitlint -E GIT_PARAMS"}
}
提交时候就会触发校验，效果如下图。
2018.12.09：
在最新的版本中，由于 参数的问题，进行了更新，配置变化如下：
{"scripts": {
- "precommit": "npm test",
- "commitmsg": "commitlint -E GIT_PARAMS"},
+ "husky": {
+ "hooks": {
+ "pre-commit": "npm test",
+ "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
+ }
+ }
}
或者在项目文件夹下执行下面的命令，会自动进行更正。
./node_modules/.bin/husky-upgrade
生成 工具
使用的工具是 ，推荐使用 -。 符合 中描述的格式，就可以用程序自动生成 。
先进行安装。
yarn add standard-version --dev
然后配置.json配置执行的脚本。
{"scripts": {"release": "standard-version"}
}
执行该脚本命令，产生的结果：生成文件 、自动修改库的版本号、产生一个 ，用工具查看如下图所示。
每一次执行，不会覆盖之前的 ，只会在 的顶部添加新的内容。
感受
网上有很多类似的介绍，自己动手去实践，得到的比看到的多的多。
参考资料
