Git Commit 规范参考

本文介绍了遵循Angular规范的Git Commit格式,包括Type、Scope、Subject等部分,强调了规范提交的好处,如清晰历史信息和自动化Changelog。同时,讨论了commitizen、commitlint和standard-version等工具的使用,帮助开发者实现更规范的Git提交。
摘要由CSDN通过智能技术生成

引子

在 github 上逛逛就可以发现,其提交的 commit 都有一定格式,工作中也有相应的规定,时间长了就能体会到其中的好处。这种约束是一种良好的实践。抽出一些时间,更详细的了解相关的资料,然后做了一些实践和总结。

规范 Commit 的好处

  1. 提供更明确的历史信息,方便判断提交目的和浏览
  2. 可以过滤某些不必要的提交,方便快速查找信息
  3. 自动化生成 Changelog
  4. 向同事、公众与其他利益关系人传达变化的性质
  5. 基于提交的类型,自动决定语义化的版本变更

以上的好处,个人认为要有一个大的前提,就是每一个提交,尽量保证其目的单一性,比如说几个 bug 看似类似,就一次性修改提交。这样做,让 commit 的信息变的复杂化,阅读不方便,也容易让人想到一些不必要的关联性。

Commit 的格式

找了几个 start 较多的库,看看提交的格式。

  1. react-commit

7-react-commit

  1. vuejs-commit

7-vuejs-commit

  1. angular-commit

7-angular-commit

网上推荐的写法是第 2 和 3 种,也就是 Angular 规范,并有配套的工具。有一个文档对 commit 的格式要求有个描述叫约定式提交。下面就根据 Angular 规范和对应文档,看看详细的说明。

每个 commit message 包含一个 headerbodyfooterheader 有一个特殊的格式包含有 typescopesubject

<type>(<scope>): <subject>
<BLANK LINE>
<body>
<BLANK LINE>
<footer>

header、body、footer 之间都要空一行,header

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值