有什么自动生成 CHANGELOG 的好方式吗？

[x97bgt]

release 时的 CHANGELOG 都是手写的，每次都要找 commit 历史找到发疯。有啥好的工具可以根据 commit 生成 CHANGELOG 的么？

[anxn]

https://github.com/orhun/git-cliff

[Trim21]

https://github.com/git-chglog/git-chglog

https://github.com/search?q=changelog+generator

[janxin]

git-chglog

[zthxxx]

https://github.com/conventional-changelog/standard-version

[KouShuiYu]

https://github.com/conventional-changelog/standard-version
用起来很简单,这是我生成的

https://github.com/ckpack/v-ui-template/blob/main/CHANGELOG.md

[nmgwddj]

我对 CHANGELOG 的存在价值持怀疑态度。commits 信息已经足够可以描述修改历史了，为什么还需要一个 CHANGELOG ？
如果你觉得 CHANGELOG 是给不同角色的人看的，那自动生成的内容往往也不能满足需求。一个 commit 的 title 80 个字符可以描述的内容及其有限，而 commit 的 description 内容又可能会非常多，更加不适合给非程序员的角色去看。
所以，自动生成 CHANGELOG 的意义是什么？

[flniu]

https://keepachangelog.com/zh-CN/1.0.0/
楼上说的有道理：更新日志绝对不应该是 git 日志的堆砌物

[KouShuiYu]

反驳上面的，用 git log 生成 changelog 的多了去了

react
https://github.com/facebook/react/blob/2b7214033e6ba15f2616012f39ae1f1ee0e573a3/CHANGELOG.md
从 git 日志提取的 https://github.com/facebook/react/blob/2b7214033e6ba15f2616012f39ae1f1ee0e573a3/scripts/devtools/prepare-release.js#L91-L112

vue
https://github.com/vuejs/vue-next/blob/master/CHANGELOG.md
用 conventional-changelog 生成的
https://github.com/vuejs/vue-next/blob/acd869f4d69b9ba43e826f62b2eeaed0b67fa1fc/package.json#L17

angular
https://github.com/angular/angular/blob/master/CHANGELOG.md
用 conventional-changelog 生成的
https://github.com/angular/angular/blob/a92a89b0eb127a59d7e071502b5850e57618ec2d/tools/gulp-tasks/changelog-zonejs.js

[indo]

对于我这种 commit 都经常乱打的人，表示还是自己手动写 changelog 更合适吧。

[fml87]

自动生成有意义的 changelog 的前提是 commit 信息必须严格遵照特定的规范，感觉也就个人项目这么搞的成本低一些

[learningman]

semantic-release

[liziwl]

@fml87 确实哈哈哈哈哈，commit 或者 changelog 总要认真写一个。像我 commit 随意写的，还是老实写 changelog 好了。

[nmgwddj]

@KouShuiYu 多不代表就是对的、最佳的。做技术的人更要跳出这个思维模式，要考虑做这件事情的意义和价值。这样才不会盲目跟风做一些无意义产出。