Git Commit Log 的小型团队最佳实践

随着团队的变大，最近在开发过程中，越来越感觉到commit log的重要性。之前的时候，团队内有人写中文log，有人写英文log；有人写的还算清晰，有人一笔更新bug就概括全貌。这些良莠不齐的commit log充斥在我们的项目中，不仅影响了查阅的效果，还会对code review产生负面的影响。因此，本文是意图从commit log的书写规范入手，并提供相应的解决方案。

注意 ：2016年1月6日，阮一峰老师写了一篇《Commit message 和 Change log 编写指南》（ http://www.ruanyifeng.com/blog/2016/01/commit_message_change_log.html ），本文主要来源于这篇文章，只是针对我们的团队，进行了一些改造和简化，以及对一些阮老师没有提及的细小之处进行了指出。

1. 书写规范

经过一番调研，因为我们是小团队，需要快速迭代，容易上手，所以对阮老师提到的commit log规范进行了 简化 ，具体如下：

: 

1.1 type

提交 commit 的类型，包括以下几种

• feat: 新功能

• fix: 修复问题

• docs: 修改文档

• style: 修改代码格式，不影响代码逻辑

• refactor: 重构代码，理论上不影响现有功能

• perf: 提升性能

• test: 增加修改测试用例

• revert: 回退，建议直接使用Github Desktop回退，而不是使用命令

1.2 subject

用一句话清楚的描述这次提交做了什么。书写要遵循以下四种规则： 格式尽量使用谓宾，使用谓宾不通顺时，可以使用主谓 ，例如：

谓宾：修复xxxx

主谓：中间件支持xxxx

• 除了名称之外，描述尽可能使用中文 ，方便不同开发者理解

• 结尾不加句号

• 描述控制在20个汉字以内

1.3 body

对本地提交的详细描述， 不建议 。我们建议多次少量提交，而不是一次巨量的提交，有助于revert和code review，也对灾难存储有容灾。

2. 撰写工具

有工具辅助，一定比手写好，这里我们使用Commitizen这个库。

安装命令：

cd 项目目录
npm install -g commitizen
commitizen init cz-conventional-changelog --save --save-exact
// 项目做些更改之后
git add .
git cz

安装完毕之后，使用git cz来代替git commit命令即可，新的commit log提交界面会如下所示：