Git Commit Message 应该怎么写?

因为入职至今,公司也没有太规定一个代码提交规范,所以一直以来,我代码提交的commit message都是简单的一句话说明了本次代码改动内容,有时候会更加精简。

但时间长了之后,当我需要回头找一下某次提交记录的时候,就会发现不太好找,首先没有一个具体的分类,比如是添加功能、还是修复bug、还是更新文档等等;其次就是有一些message写得不是很清晰,不太能一眼明了那次改动是什么内容。

后来决定,需要重新学一学关于commit message的写法规范。

Commit Message的好处

  • 每一条提交记录的message能够提供更多的有效信息,方便我们快速浏览;
  • 可以使用git log --grep <keyword>过滤掉某些commit,便于快速查找信息;
  • 可以直接从commit生成Change log

Commit Message格式

目前Commit Message规范使用较多的是Angular团队的规范,继而衍生了Conventional Commits sepcification

Commit Message包括三个部分:HeaderBodyFooter。格式如下:

<type>(<scope>): <subject>
< 空一行 >
<body>
< 空一行 >
<footer>

其中,Header是必填的,BodyFooter可以省略不写。

Header

Header包含三个部分:typescopesubject。其中scope是可选项。

<type>(<scope>): <subject>

# example
feat($route): add support for the `reloadOnUrl` configuration option

type

type是用于说明commit的类别,具体的标识如下:

  • 2
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值