团队管理之git提交规范

commit 三要素

主流的提交规范一般包括:标题(类型、精简总结)、内容、备注 。其中精简总结 是必填的,类型 最好也填一下,其余都是选填。
下面大冰块来见到那介绍一下这三个方面具体都指的是什么:

一、标题

标题分为 类型改动范围精简总结 三部分:

1.1 类型

规范的主要类型如下:

  • feat:新功能或功能变更相关
  • fix:修复bug相关
  • docs:改动了文档,注释相关
  • style:修改了代码格式化相关,如删除空格、改变缩进、单双引号切换、增删分号等,并不会影响代码逻辑
  • refactor:重构代码,代码结构的调整相关(理论上不影响现有功能)
  • perf:性能改动,性能、页面等优化相关
  • test:增加或更改测试用例,单元测试相关
  • build: 影响编译的更改相关,比如打包路径更改、npm过程更改等
  • ci:持续集成方面的更改。现在有些build系统喜欢把ci功能使用yml描述。如有这种更改,建议使用ci
  • chore:其它改动相关,比如文件的删除、构建流程修改、依赖库工具更新增加等
  • revert:回滚版本相关

其实实际开发中最常用的就是 feat、fix 和 perf,git提交基本上都是实现需求,更改bug,性能优化。除了上述这些主要类型,我们也可以根据团队要求定制类型,毕竟规范是死的,人是活的嘛。比如为了大家更易读,我们只留几个常用的,并且全改成中文,如:

  • 功能更改:新功能或功能变更相关
  • 修复bug:修复bug相关
  • 优化:性能改动,性能、页面等优化相关

没有好与不好之分,适合团队的就是最好的!

1.2 改动范围

当项目划分为好几个模块的时候,指定改动的模块是很有必要的事情,这样在git提交记录中,很容易看出提交者更改的是哪个模块。比如本次修改了compiler(编译器)模块,下次修改了 router(路由)模块,一目了然。如:

  • compiler
  • router

    1.3 精简总结

    必填的精简总结是非常重要的,一般是是总结概括的文字。要让人一眼就能看出来主要提交了什么,是添加了功能还是解决了问题,同时它也是大多数git管理工具默认展示的一行。如果你写的标准,那么提交记录看起来就很漂亮很规整。例如:
    fix: 修复了无限抽奖的bug
    复制代码

    二、内容

    内容主要填写详细的改动内容,可换行。当然,不必像写一篇小作文似的长篇大论,毕竟我们程序员的时间还是很宝贵的。如果精简总结写的比较完美,内容不写也是没关系的。不过如果更改确实很多,并且时间充裕的话,把本次提交内容的实现、需求以及背景都填写,是很负责的做法。比如:
    fix: 修复了无限抽奖的bug

    在网络不好时,多次抽奖的接口可以被重复调用。
    此次更改了抽奖接口的逻辑判定,在并发请求中……采用了……所以……。
    复制代码

    三、备注

    备注看起来并不是那么重要,主要作用就是有一些额外的hook补充,比如提交记录之后,自动触发代码联动编译,或者自动生成git提交的通知。

    其他

    规范了团队的git提交,commit log记录一目了然,配合自动化集成工具即可自动生成git change log。以及调用邮箱接口提示,自动发送提交、构建、发版的人员记录,所以团队管理的git的提交规范是很有必要的,甚至是不可或缺的一部分。