commitizen
让你的git
提交更加规范
安装和使用
全局安装
bash
npm i commitizen -g
使用
git cz -m"init"
如果你不是运行在Commitizen friendly
环境中,git cz
就和普通的git commit
一模一样。
创建友好环境 Making your repo Commitizen friendly
此环境即为commitizen
适配器,通过问答选择的方式来规范提交结构信息。
通过commitizen
工具来安装符合AngularJS
提交说明规范的适配器:
bash
commitizen init cz-conventional-changelog --save-dev --save-exact
如果已有适配器,可通过--force
来强制安装
此操作实际做的工作如下:
- 安装
cz-conventional-changelog
适配器模块到项目 - 在
package.json
中添加如下配置:json"config": { "commitizen": { "path": "cz-conventional-changelog" } }
在 2 中,也可以选择把这个设置放置到单独文件中:.czrc
:
json
{
"path": "cz-conventional-changelog"
}
git-cz
无需安装commitizen
、cz-conventional-changelog
适配器,使用指定命令即可完成一次规范的代码提交
安装:
bash
npm i git-cz --save-dev
使用
bash
npx git-cz
或者在package.json
中配置scripts
:
json
{
"scripts": {
"commit": "git add . && npx git-cz"
}
}
使用:npm run commit
type
,提交类型:feat
: 新增一个功能fix
: 修复 bugdocs
: 仅仅修改了文档,比如 README, CHANGELOG, CONTRIBUTE 等等style
: 仅仅修改了空格、格式缩进等等,不改变代码逻辑refactor
: 代码重构,没有加新功能或者修复 bugperf
: 优化相关,比如提升性能、体验test
: 测试用例,包括增加缺失用例或者修正测试用例
scope
,所属模块,可忽略subject
,简短描述body
,详细描述