md 生成目录 码云_GIT实践之生成规范的commit message

分享一篇团队内的小伙伴创作的GIT实践

一、为什么需要规范？

• 无规矩不成方圆，编程也一样。

• 如果你有一个项目，从始至终都是自己写，那么你想怎么写都可以，没有人可以干预你。可是如果在团队协作中，大家都张扬个性，那么代码将会是一团糟，好好的项目就被糟践了。不管是开发还是日后维护，都将是灾难。

• Git Commit 规范可能并没有那么夸张，但如果你在版本回退的时候看到一大段糟心的Commit，恐怕会懊恼不已吧。所以，严格遵守规范，利人利己。

二、具体规则

先来看看公式：

• type 用于说明 commit 的类别，只允许使用下面7个标识。

  

• scope用于说明 commit 影响的范围，比如数据层、控制层、视图层等等，视项目不同而不同。

• subject 是 commit目的的简短描述，不超过50个字符。

• 以动词开头，使用第一人称现在时，比如change，而不是changed或changes

• 第一个字母小写

• 结尾不加句号(.)

三、Commitizen

• mac如果没有安装npm命令，可以用brew命令下载

  

• 安装命令如下：

  

• 然后，在项目目录里，运行下面的命令，使其支持 Angular 的 Commit message 格式。

  

• 以后，凡是用到git commit命令，一律改为使用git cz。这时，就会出现选项，用来生成符合格式的 Commit message。

  

  四、validate-commit-msg

Node 插件 validate-commit-msg 来检查项目中 Commit message 是否规范,
插件安装在项目中.git的hook目录下，命名为validate-commit-msg.js。

1.首先，安装插件：

2.使用方式一，建立 .vcmrc 文件：

3.使用方式二：写入 package.json

4.可是我们如果想自动使用 ghooks 钩子函数呢？

五、生成 Change log

如果你的所有 Commit 都符合 Angular 格式，那么发布新版本时， Change log 就可以用脚本自动生成

• 生成的文档包括以下三个部分:

  

• 每个部分都会罗列相关的 commit ，并且有指向这些 commit的链接。当然，生成的文档允许手动修改，所以发布前，你还可以添加其他内容。

• conventional-changelog
  就是生成 Change log 的工具，运行下面的命令即可:

  

• 上面命令不会覆盖以前的 Change log，只会在CHANGELOG.md的头部加上自从上次发布以来的变动

• 如果你想生成所有发布的 Change log,可以将其写入package.json的scripts字段

  

• 以后，直接运行下面的命令即可。