Skip to content

[Commitizen]信息交互工具

Commitizen是一个提交日志工具,辅助开发者使用提交规则

预配置

需要安装NodeJS,参考:nodeJS安装

安装Commitizen

# 全局安装
$ npm install -g commitizen

安装Adapter

Commitizen支持多种不同的提交规范,可以安装和配置不同的适配器实现

Conventional Commit规范为例

全局配置(推荐)

# 安装
$ npm install -g cz-conventional-changelog
# 配置
$ echo '{ "path": "cz-conventional-changelog" }' > ~/.czrc

本地配置

# 安装
commitizen init cz-conventional-changelog --save-dev --save-exact

安装完成后,查看是否在package.json中已加入cz-conventional-changelog信息:

...
...
  "devDependencies": {
    "cz-conventional-changelog": "^3.0.2"
  },
  "config": {
    "commitizen": {
      "path": "./node_modules/cz-conventional-changelog"
    }
  }
}

测试

安装完成后,使用git-cz替代git commit完成提交操作,

$ git cz
cz-cli@4.0.3, cz-conventional-changelog@3.0.2

? Select the type of change that you're committing: (Use arrow keys)
❯ feat:     A new feature 
  fix:      A bug fix 
  docs:     Documentation only changes 
  style:    Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc) 
  refactor: A code change that neither fixes a bug nor adds a feature 
  perf:     A code change that improves performance 
  test:     Adding missing tests or correcting existing tests 
(Move up and down to reveal more choices)

通过提示信息辅助你完成标准化的提交日志

git-cz支持git commit所有的参数设置

正文换行使用\n操作,比如正文内容如下:新增事项:\n1. 测试1\n2. 测试2\n3. 测试

build(npm): 加入package.json

新增事项:
1. 测试1
2. 测试2
3. 测试

徽章

README中添加commitizen友好徽章