前端生成CHANGELOG指南
目的
多人协作项目中规范化commit,提取关键信息。
Angular 规范
1 | <type, 必填>(<scope,可省略>): <subject,必填> |
标识 - type
CHANGELOG 标识名 | 说明 | 是否会出现在CHANGELOG中 |
---|---|---|
feat | 新功能(feature) | 会 |
fix | 修补bug | 会 |
docs | 文档(documentation) | 自行决定 |
style | 格式(不影响代码运行的变动) | 自行决定 |
refactor | 重构(即不是新增功能,也不是修改bug的代码变动) | 自行决定 |
test | 增加测试 | 自行决定 |
chore | 构建过程或辅助工具的变动 | 自行决定 |
scope
scope用于说明 commit 影响的范围,比如某个模块、某个功能。
subject
subject是 commit 目的的简短描述,不超过50个字符。
body
body部分是对本次 commit 的详细描述,可以分成多行。
footer
footer部分只用于两种情况:不兼容变动、关闭 Issue。
利用conventional-changelog-cli
- 安装
1
npm install -g conventional-changelog-cli
- package.json增加
1
2
3
4"scripts": {
...
"version": "conventional-changelog -p angular -i CHANGELOG.md -s && git add CHANGELOG.md"
}, - 发版前利用npm version升版本号升版本并提交
1
2
3
4
5
6
7
8# From 1.0.0 -> 1.0.1
npm version patch
# From 1.0.1 -> 1.1.0
npm version minor
# From 1.1.0 -> 2.0.0
npm version major【参考】1
npm version minor -m 'docs(CHANGELOG): [tag]'
感谢您的阅读,本文由 Astar 版权所有。如若转载,请注明出处:Astar(http://example.com/2022/01/17/%E5%89%8D%E7%AB%AF%E7%94%9F%E6%88%90CHANGELOG%E6%8C%87%E5%8D%97/)