Git Commit 提交注释说明

- 1 min

1. 注释说明

  1. 注释较多内容的时候,建议使用标题加正文的方式,标题与正文以空格分割一下,若注释较少则可只写内容
  2. 标题尽量简洁,尽量使用祈使语气
  3. 正文每行的长度不易过长,否则不易阅读
  4. 正文是解释是什么和为什么,而不是怎么实现的
  5. 如果可以尽量写英文注释(像我英文这么烂只能写写中文了)

2. 关键字

以下关键字尽量出现在正文开头,表示当前完成的功能

3. 例子

新增状态码设置,修改账号验证方式,修复邮箱验证已经删除账号注册登录

1.Feat 状态码设置接口,/api/code/get
2.Mod 账号验证方式,不允许出现特殊字符,如…
3.Fix 邮箱验证不通过的问题
4.Del 账号注册登录,改为手机号验证码登录

PS:

由于本人水平有限,文章在表述和代码方面如有不妥之处,欢迎批评指正。

rss facebook twitter github gitlab youtube mail spotify lastfm instagram linkedin google google-plus pinterest medium vimeo stackoverflow reddit quora quora