赞
踩
约定式提交规范是一种基于提交消息的轻量级约定。 它提供了一组用于创建清晰的提交历史的简单规则; 这使得编写基于规范的自动化工具变得更容易。 这个约定与 SemVer 相吻合, 在提交信息中描述新特性、bug 修复和破坏性变更。
提交说明的结构如下所示:
<类型>[可选的作用域]: <描述>
[可选的正文]
[可选的脚注]
大致分为三个部分(使用空行分割):
commit 的类型:
commit 影响的范围, 比如: route, component, utils, build…
commit 的概述
commit 具体修改内容, 可以分为多行.
一些备注, 通常是 BREAKING CHANGE 或修复的 bug 的链接.
提交说明包含了下面的结构化元素,以向类库使用者表明其意图:
fix
的提交表示在代码库中修复了一个 bug(这和语义化版本中的 PATCH
相对应)。feat
的提交表示在代码库中新增了一个功能(这和语义化版本中的 MINOR
相对应)。BREAKING CHANGE:
的提交,表示引入了破坏性 API 变更(这和语义化版本中的 MAJOR
相对应)。 破坏性变更可以是任意 类型 提交的一部分。fix:
和 feat:
之外的提交 类型 也是被允许的,例如 @commitlint/config-conventional(基于 Angular 约定)中推荐的 chore:
、docs:
、style:
、refactor:
、perf:
、test:
及其他标签。 我们也推荐使用improvement
,用于对当前实现进行改进而没有添加新功能或修复错误的提交。 请注意,这些标签在约定式提交规范中并不是强制性的。并且在语义化版本中没有隐式的影响(除非他们包含 BREAKING CHANGE)。 可以为提交类型添加一个围在圆括号内的作用域,以为其提供额外的上下文信息。例如 feat(parser): adds ability to parse arrays.
。参考资料:https://www.conventionalcommits.org/zh-hans/v1.0.0-beta.4/
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。