git提交注释规范插件

1、前言

为什么要注重代码提交规范?

在团队协作开发时,每个人提交代码时都会写 commit message。
每个人都有自己的书写风格,翻看我们组的git log, 可以说是五花八门,十分不利于阅读和维护。
一般项目开发都是多分支共存,master、develop、feature、hotfix、release等分支,在这么多分支中,我们会有一个稳定的master分支,但是我们需要将分支代码进行merge。存在规范的commit message可以帮助我们很轻松的合并代码以及发现问题。例如使用Jenkins自动化部署时,我们可以根据jenkins拉取commit message中的Closes issues验证BUG等。
因此,我们需要制定统一标准,促使团队形成一致的代码提交风格,更好的提高工作效率,成为一名有追求的工程师。

2、sourceTree提交注释模版配置

sourceTree - 偏好设置-提交
在这里插入图片描述
点击提交自动就出现
在这里插入图片描述

【提交类型】:feature、fix、docs、style、refactor、perf、test、build:、ci、chore、revert
【提交影响范围】:
【标题】: 
【功能描述】:
【不兼容变动】: 
【关闭 Issue】: 

3、idea提交注释模版配置

使用Git Commit Message Helper插件来辅助提交注释信息

3.1、安装Git Commit Message Helper

idea-preferences-Plugins-Browser repositories-搜索Git Commit Message Helper,如下图示:
在这里插入图片描述
安装完之后,重启idea即可完成配置。

3.2、配置模版信息

idea-preferences-Other Settings -GitCommitMessageHelper,如下图示:

在这里插入图片描述

type说明
type用于说明 commit 的类别,只允许使用下面标识

feature:新功能(feature)
fix:修补bug
docs:文档(documentation)
style: 格式(不影响代码运行的变动,空格,格式化,等等)
refactor:重构(即不是新增功能,也不是修改bug的代码变动)
perf: 性能 (提高代码性能的改变)
test:增加测试或者修改测试
build: 影响构建系统或外部依赖项的更改(maven,gradle,npm 等等)
ci: 对CI配置文件和脚本的更改
chore:对非 src 和 test 目录的修改
revert: Revert a commit

点击template

【提交类型】:#if($type)${type}#end
${newline}
【提交影响范围】:#if($scope)${scope}#end
${newline}
【标题】: #if($subject)${subject}#end
${newline}
【功能描述】:#if($body)${body}#end
${newline}
#if($changes)【不兼容变动】: ${changes}#end
${newline}
#if($closes)【关闭Issue】: ${closes}#end

3.3、插件使用
在Commit代码处,选择使用Git Commit Message Plugins插件,如下图所示,填写项详细含义请查看《插件详解》
在这里插入图片描述

在这里插入图片描述
总共分为3大部分,Header, Body,Footer详细讲解请看下节。
在这里插入图片描述
三、插件讲解
主要分为下面三个部分: Header, Body,Footer。

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

下面详细解释下个个部分的含义。

1、Header
Header的部分只有一行,包括三个字段: type(必需), scope(可选), subject(必需)

对应到idea插件上图的配置分别为 Header部分的:

type(必需) Type of change commit类别
scope(可选) Scope of this change commint影响的范围
subject(必需)**** Short description 简短的描述
1.1 type
type用于说明 commit 的类别,只允许使用下面标识

feat:新功能(feature)
fix:修补bug
docs:文档(documentation)
style: 格式(不影响代码运行的变动,空格,格式化,等等)
refactor:重构(即不是新增功能,也不是修改bug的代码变动)
perf: 性能 (提高代码性能的改变)
test:增加测试或者修改测试
build: 影响构建系统或外部依赖项的更改(maven,gradle,npm 等等)
ci: 对CI配置文件和脚本的更改
chore:对非 src 和 test 目录的修改
revert: Revert a commit

1.2 scope
scope用于说明 commit 影响的范围,比如数据层、控制层、视图层等等,视项目不同而不同。

1.3 subject
subject是 commit 目的的简短描述,不超过50个字符。

以动词开头,使用第一人称现在时,比如change,而不是changed或changes
第一个字母小写
结尾不加句号(.)

2、Body
Body 部分是对本次 commit 的详细描述,可以分成多行。下面是一个范例。

如有必要,更详细的说明文本。包装它
大概72个字左右。

后面的段落在空行之后。

-要点也可以
-使用悬挂缩进

有一个注意点。

(1)应该说明代码变动的动机,以及与以前行为的对比。

3、Footer
Footer 部分只用于两种情况。

(1)不兼容变动

如果当前代码与上一个版本不兼容,则 Footer 部分以BREAKING CHANGE开头,后面是对变动的描述、以及变动理由和迁移方法。

(2)关闭 Issue

如果当前 commit 针对某个issue,那么可以在 Footer 部分关闭这个 issue 。

Closes #234

也可以一次关闭多个 issue 。

Closes #123, #245, #992

最后, 一个完整的commit message示例可能如下:
在这里插入图片描述

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值