广告位联系
返回顶部
分享到

Git Commitizen提交规范化自动生成changelog文件

相关技巧 来源:互联网 作者:佚名 发布时间:2022-09-16 20:32:57 人浏览
摘要

我们在使用一个比较厉害的框架或者库的时候,经常可以看到 CHANGELOG.md,维护版本更新内容。 很多时候,特别是在你开源自己的一个工具或库时,这种版本更新内容是非常有必要的,

我们在使用一个比较厉害的框架或者库的时候,经常可以看到 CHANGELOG.md,维护版本更新内容。

很多时候,特别是在你开源自己的一个工具或库时,这种版本更新内容是非常有必要的,如果用户使用了你的轮子,连更新内容都不知道,试问你敢用吗? 那么这些都是怎么写的呢?每次发版都要手动记录吗?显然不是,这些都是靠提条记录生成的。

比如我们在 github 上随便找一个库:https://github.com/vuepress/vuepress-next,可以看到它就有这个文件

点进去可以查看具体内容:注意我画红线的这 2 个,我们是可以跳到对应 issue 和对应代码提交记录的。

Commitizen 介绍

1、团队约束

生成这种 CHANGELOG 有一个前提,就是团队成员都按规矩提交。人不是机器,习惯不养成往往会忽略,这种约束还是让工具来做吧。

2、Commitizen 是一个撰写符合 Commit Message 格式标准的一款工具,至于标准 Commit Message 格式标准,可以百度一下或者一会提交示例介绍。

3、局部安装 commitizen:npm install commitizen -D

4、执行脚本设置 package.json

在项目根目录下运行下面命令,使其支持angular的 Commit message 格式

1

2

3

4

// 如果你使用npm执行下面命令:

commitizen init cz-conventional-changelog --save-dev --save-exact

// 如果使用yarn,则执行下面:

commitizen init cz-conventional-changelog --yarn --dev --exact

注意,–save-exact 相当于锁定版本号

此时 package.json 新增了这部分内容

1

2

3

4

5

6

7

8

9

10

11

12

13

14

{

  "scripts": {

    "commit": "cz"

  },

  "devDependencies": {

    "commitizen": "^4.2.4",

    "conventional-changelog-cli": "^2.2.2"

  },

  "config": {

    "commitizen": {

      "path": "./node_modules/cz-conventional-changelog"

    }

  }

}

5、修改代码提交过程介绍

这时候就可以提交尝试下,提交的时候直接执行刚才添加的脚本:yarn commit 或者 npm run commit,然后就会看到让你选择的各种页面,选择即可

第一步: 选择这次提交的内容类型:提交类型是以后生成 CHANGELOG 分类题目

第二步: 这次提交影响范围

第三步:简短描述:如果你使用 gitlab 或者 github 进行远程分支 Merge requset 的时候,这个就是默认的title

第四步:详细描述

第五步:是否重大更新(改变):一般具有重要的大版本或者破坏原来代码的时候需要标记一下

第六步:这次提交对哪些打开的 issue 有影响:类似于 github 开源模式,代码的维护不论需求还是 fix都有对应的issue讨论进行code的支撑。git message 这一步就是为了关联issue。如果选择是,可写上相关issue 对应号码。(也就是上面的那 2 个可以跳转的地方)

自动产生CHANGELOG

那么正规的写提交记录最后就是为了让团队其他人看懂,还有一个目的是为了更规范的产生CHANGELOG,下面看看自动产生CHANGELOG的步骤。

1、安装产生 changelog 插件 conventional-changelog-cli:

npm install -D conventional-changelog-cli

2、在 package.json 添加脚本

1

"changelog": "conventional-changelog -p angular -u -i CHANGELOG.md -s -r 0"

3、执行脚本,查看结果:yarn changeLog 或 npm run changeLog

最后即可生成一个提交日志文件

我这里测试了下:

feat 是 npm run commit 按步骤提交的

fix 是直接 git commit -m "fix: test 符号" 提交的

可以看到都生成了日志文件,所以如果团队每个人都能按 Commit 规范提交的话,第一步 Commitizen 约束是可以不需要的(但是会存在一个问题就是不能实现 issue 与 commitId 的代码提交记录的联动了)。


版权声明 : 本文内容来源于互联网或用户自行发布贡献,该文观点仅代表原作者本人。本站仅提供信息存储空间服务和不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权, 违法违规的内容, 请发送邮件至2530232025#qq.cn(#换@)举报,一经查实,本站将立刻删除。
原文链接 : https://juejin.cn/post/7142780772141760542
相关文章
  • 本站所有内容来源于互联网或用户自行发布,本站仅提供信息存储空间服务,不拥有版权,不承担法律责任。如有侵犯您的权益,请您联系站长处理!
  • Copyright © 2017-2022 F11.CN All Rights Reserved. F11站长开发者网 版权所有 | 苏ICP备2022031554号-1 | 51LA统计