gitcommit提交规范和规范校验⼀、⽬的
在多⼈协作项⽬,如果代码风格统⼀、提交信息准确,那么在后期协作以及BUG处理时会更加⽅便。格式化的commit message有以下⼏个好处:
1. ⽅便快速检索历史提交信息,只看⾏⾸即可知晓commit的⽬的
git log HEAD --pretty=format:%s
2. 可以过滤某些commit(⽐如⽂档更新),便于快速查信息
git log HEAD --pretty=format:%s --grep 新功能
3. 可以直接从commit⽣成changelog,说明与上⼀版本发布的差异
通过changelog,测试知晓本次变更修改范围
⼆、格式
每⼀次提交,信息都必须遵循commit信息格式,包含Header、Body、Footer三个部分。commit信息格式
三、⼯具
3.1 依赖安装
# 安装所需依赖, changelog-sn⾄少2.x版本
npm install -D changelog-sn standard-version
3.2 配置commitlint和commitizen
代码仓库根⽬录创建⽂件mitlintrc.js和.czconfigrc.js
3.2.1 配置mitlintrc.js内容
rules: {
'subject-empty': [2, 'never'],js assign
'type-empty': [2, 'never'],
'scope-empty': [2, 'never'],
'type-enum': [
2,
'always',
[
'新功能',
'修复',
'优化',
'重构',
'⽂档',
'chore',
'revert',
'WIP',
'docs',
'build',
'release'
]
]
}
})
3.2.2 配置.czconfigrc.js
types: [
{ value: '新功能', name: '新功能 : 新增加⼀个功能' },
{ value: '修复', name: '修复 : ⼀个 bug 修复' },
{ value: '优化', name: '优化 : 提升性能的代码更改' },
{ value: '重构', name: '重构 : 不涉及修复bug和新功能开发的代码更改' },
{ value: '⽂档', name: '⽂档 : 只有⽂档发⽣改变' },
{ value: 'chore', name: '构建 : 修改持续集成的配置⽂件和脚本' },
{ value: 'revert', name: '撤销 : 撤销⼀个历史提交' },
{ value: 'WIP', name: '待完成 : 研发中的提交备份' }
]
,
messages: {
type: '选择你提交的信息类型:',
scope: '选择本次提交的改变所影响的范围?',
customScope: '本次提交的改变所影响的范围?',
subject: '写⼀个简短的变化描述,尽量包含主谓宾结构,杜绝简单的单词:\n',
body: '提供更详细的变更描述 (按 enter 跳过). 使⽤ "|" 换⾏:\n',
breaking: '列出所有的不兼容变更 (按 enter 跳过):\n',
footer: '列出此次改动解决的所有 issues (如:"#123, #234")(按 enter 跳过):\n',
confirmCommit: '确认提交以上内容信息?'
},
allowBreakingChanges: ['refactor', 'chore'],
breakingPrefix: 'WARNING:',
skipQuestions: ['body'],
subjectLimit: 100,
breaklineChar: '|',
footerPrefix: 'CLOSED:'
}
3.2.3 配置package.json
{
"scripts": {
"log": "changelog-sn -i CHANGELOG.md -s -r 2",
"cz": "git add . && git cz"
},
"husky": {
"hooks": {
"commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
}
},
"config": {
"commitizen": {
"path": "./node_modules/cz-customizable"
},
"cz-customizable": {
"config": "./.czconfigrc.js"
}
},
"devDependencies": {
"changelog-sn": "2.0.5"
}
}
作者:逆黄
链接:www.jianshu/p/d20ecbc66ae1
来源:简书
著作权归作者所有。商业转载请联系作者获得授权,⾮商业转载请注明出处。
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论