内容简介:Git 每次提交代码,都要写 Commit message 来说明本次的提交内容。当提交的内容比较多的时候, 可以执行在项目开发过程中, 使用 git commit 提交的信息可以很好的反应项目的开发进展情况。 所以应当规范 git message 的格式, 来更加清晰明了的说明每次的提交目的。
Git 每次提交代码,都要写 Commit message 来说明本次的提交内容。
git commit -m "hello word" 复制代码
当提交的内容比较多的时候, 可以执行 git commit
, 使用跳出来的文本来编辑提交信息。
git commit 复制代码
在项目开发过程中, 使用 git commit 提交的信息可以很好的反应项目的开发进展情况。 所以应当规范 git message 的格式, 来更加清晰明了的说明每次的提交目的。
Angular Commit message
关于 Git message 的写法规范社区中有很多种, 目前使用较为广泛的是Angular 规范
在 Angular
规范中, 每次提交, Commit message 都包括三个部分: Header、Body 和 Footer;
<type>(<scope>):<subject> ## header 部分 // 空一行 <body> ## body 部分 // 空一行 <footer> ## footer 部分 复制代码
::: tip
- 这三个部分种, Header 是必须的, Body 和 Footer 可以省略。
- 不管哪个部分,为了在输出 log 时的美观,任何一行的都不得超过 72 个字符。 :::
Header 部分
Header 部分只有一行, 包括三个字段: type
(必须)、 scope
(可选)、 subject
(必须);
type
type
用于说明 commit 的类型, 在 Angular 规范
种, 只允许 7 种常用类型和一种特殊类型(revert):
feat: 新功能 (feature) fix: 修补 bug docs: 文档 (ocumentation) style: 格式 (不影响代码运行) refactory: 重构 (既不是新增功能, 也不是修改 bug 的代码改动) test: 增加测试 chore: 构建过程或辅助 工具 的变动 revert: 撤销以前的 commit; header 部分需要跟被撤销 Commit 的 Header 复制代码
scope
scope
用于说明 commit
影响的范围, 比如说数据层、控制层、视图层等等
subject
subject
是 commit
的简短描述, 不超过 50 个字符。
::: tip 以动词开头, 使用第一人称现在时, 比如 change
而不是 changed
或者 changes
第一个字母小写 结尾不加句号 :::
body
body
部分是对本次 commit
的详细描述, 可以分为多行。
footer
在很多情况下, 是不使用这部分的内容的, 但是在下面两种情况下,回使用到 footer
- 不兼容变动说明 如果当前代码与上一个版本不兼容, 则
footer
部分需要使用BREAKING CHANGE
开头, 后面是对变动的描述以及变动理由和变动方法.
BREAKING CHANGE: isolate scope bindings definition has changed. To migrate the code follow the example below: Before: scope: { myAttr: 'attribute', } After: scope: { myAttr: '@', } The removed `inject` wasn't generaly useful for directives so there should be no code using it. 复制代码
- 关闭 Issue 如果当前 commit 是针对 某个或者某几个
issue
, 那个可以在 footer 部分关闭issue
Closes #123 复制代码
关闭多个 issue
Closes #123, #234, #345 复制代码
Commitizen
在项目的开发过程中,编程人员遵守 Angular 规范
需要编写更多的 git message 信息, 使用 Commitizen 来进行交互式的 message 输入。
- 安装
npm install -g commitizen 复制代码
然后,在项目目录里,运行下面的命令,使其支持 Angular 的 Commit message 格式。
commitizen init cz-conventional-changelog --save --save-exact 复制代码
当需要 git commit
的时候使用 git cz
来生成符合规范的 git message.
commitlint 校验 message
git cz
命令为 git message 提供了一个规范的 message 模板, 这时使用 git commit -m
或者 使用 git cz
依旧不能严格限制 git message 内容, 为了严格规范需要使用 commitlint 来拒绝不规范的 git message 内容。
- 安装
npm install --save-dev @commitlint/config-conventional @commitlint/cli 复制代码
- 添加配置文件 (为了使 commitlint 生效)
echo "module.exports = {extends: ['@commitlint/config-conventional']};" > commitlint.config.js 复制代码
- 或者在
package.json
文件中添加
"commitlint": { extnds: [ "@commitlint/config-conventional" ] } 复制代码
触发 commitlint
配置好 commitlint
, 还需要设置 触发 commitlint
的时机。
Git
中自带不同的 hook
, 当某些事件发生的时候,会触发相对应的 hook
, 这些 hook
脚本存放在项目根目录的 .git/hooks
目录下。
commit-msg
是其中一个 hook
, 在 git commit
提交的时候触发。 可以使用 husky 来自定义 commit-msg
触发时候的事件。
ghooks
-
安装
npm install husky -D
-
在
package.json
中添加代码
"config": { "ghooks": { "commit-msg": "commitlint -e $GIT_PARAMS" } } 复制代码
在 git commit-msg
这个钩子中会触发 commitlint
的操作。
配合 lint-staged 进行代码检验和修复
在完成了 git message
的校验之后, 可以继续使用 lint-staged 和 git hooks
来进行代码提交前的语法、风格的验证和修复。
npm install -D lint-staged .lintstagedrc
{ "*.{js,vue}": ["eslint --fix", "git add"] } 复制代码
- 或者在
package.json
中写入
"lint-staged": { "*.{js,vue}": ["eslint --fix", "git add"] } 复制代码
- 在
husky
配置中添加触发时机
"husky": { "hooks": { "pre-commit": "lint-staged" } } 复制代码
这样在每次提交之前都会触发 pre-commit
这个 hook
, 从而触发 .lintstagedrc
或者 package.json
中的 lint-staged
里面的配置。 在例子中,我们配置了对所有 .js
或者 .vue
结尾的文件进行 eslint
的修复, 并且当修复之后再次执行 git add
将修改后的文件再次放到暂存区。 这样就可以保证每次提交的代码都是统一风格的代码了。
::: tip lint-staged
只对此次提交所在暂存区的文件(git add后的文件)进行一系列的检查、修复、格式化操等作。 :::
自动生成 Change log 并更新 Version
当使用 Angular 规范
提交 git message
, 还可以使用 standard-version 生成 Change log
文档。 生成的文档将会包括下面三个部分。
new features // 新增功能记录 bug fixes // 解决 bug 记录 breaking changes // 不兼容变动记录 复制代码
每一部分都会列出相关的 commit
, 并且指向这些 commit
的连接。 conventional-changelog
使用如下:
- 安装
npm install -g standard-version 复制代码
- 在
package.json
中添加script
字段
"script": { "release": "standard-version" } 复制代码
运行 npm run release
将会执行下面的步骤。
1. 修改 package.json package-lock.json 中的版本号 2. 生成 CHANGELOG.md 文件。 3. 提交 package.json package-lock.json CHANGELOG.md 文件 4. 给本次提交打上 tag 复制代码
以上所述就是小编给大家介绍的《项目中的 git message 规范》,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对 码农网 的支持!
猜你喜欢:- 项目组合、项目集、项目管理实践经验及思考
- 项目管理:如何避免项目延期?
- 【Vue项目总结】后台管理项目总结
- 【Vue项目总结】项目nginx部署
- 分享一个vue项目“脚手架”项目
- 项目管理基础:什么是项目管理?
本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。