Java Git Commit Message使用规范

更新时间：2022年08月28日 08:27:09 作者：JAVA旭阳

这篇文章主要介绍了Java Git Commit Message使用规范，文章围绕主题展开详细的内容介绍，具有一定的参考价值，感兴趣的小伙伴可以参考一下，希望对你的学习有所帮助

概述

不知道大家在各自项目中是如何写提供代码的commit message, 我们项目有的同事写的很简单，压根不知道提交了什么内容，是新功能还是缺陷修复。本质上 commit message就是为了让团队成员知道这次提交的内容，为此，我们出了一个规范，约定团队的每个同事按照这个规范提交代码，达到通过message能够了解此次修改的内容。

一、Commit message 的格式

每次提交，Commit message 都包括三个部分：Header，Body 和 Footer。

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

其中，Header、针对feat和fix类型的提交内容 Body 是必需的。不管是哪一个部分，任何一行都不得超过72个字符（或100个字符）。这是为了避免自动换行影响美观。

1.1 Header

Header部分只有一行，包括三个字段： type（必需）、scope（必需）和subject（必需）。
（1）type
type用于说明 commit 的类别，只允许使用下面7个标识。

feat：新功能（feature）
fix：修补bug
docs：文档（documentation）
style： 格式（不影响代码运行的变动）
refactor：重构（即不是新增功能，也不是修改bug的代码变动）
test：增加测试
build：构建过程或辅助工具的变动

（2）scope
scope用于说明 commit 影响的范围，比如指标模板、规则上下线等等，视项目不同而不同。
（3）subject
subject是 commit 目的的简短描述，不超过50个字符。

1. 以动词开头，使用第一人称现在时，比如change，而不是changed或changes
2. 第一个字母小写
3. 结尾不加句号（.）

1.2 Body

Body 部分是对本次 commit 的详细描述，可以分成多行。

1. 需要简要的列出各种正向或者反向的测试场景，测试通过，填pass。
2. 增加修改人信息

二、例子

2.1 feat例子

feat(规则上下线、构建、生效、仿真生效): 添加规则上下线功能

1. 规则上下线主流程，引擎正常订阅，fldl生成正常。 pass
2. 规则上下线，传入不存在的规则编号，异常提示。 pass

提交人：xxx

2.2 fix例子

fix(模型模块): 模型测试失败

1. 导入mar模型，包含衍生字段。 pass
2. 导入mar模型，不包含衍生字段。 pass

提交人：xxx

插件推荐

idea可以安装代码提交规范的插件。

1.安装插件

2.提交时选择插件提交

到此这篇关于Java Git Commit Message使用规范的文章就介绍到这了,更多相关Java Git Commit Message内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Seata AT模式TM处理流程图文示例详解
这篇文章主要为大家介绍了Seata AT模式TM处理流程图文示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-09-09
Springboot传参详解
这篇文章主要介绍了Springboot传参的相关知识,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
2023-11-11
mybatis配置Mapper.xml文件时遇到的问题及解决
这篇文章主要介绍了mybatis配置Mapper.xml文件时遇到的问题及解决方案，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-01-01
java时间格式的简单整理
这篇文章主要介绍了java时间格式的简单整理，文中通过示例介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友可以参考一下
2019-06-06
23种设计模式（18）java备忘录模式
这篇文章主要为大家详细介绍了23种设计模式之java备忘录模式，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2018-01-01
hadoop是什么语言
Hadoop是一个由Apache基金会所开发的分布式系统基础架构。用户可以在不了解分布式底层细节的情况下，开发分布式程序。充分利用集群的威力进行高速运算和存储
2017-09-09
SpringMVC结合天气api实现天气查询
这篇文章主要为大家详细介绍了SpringMVC结合天气api实现天气查询，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2017-05-05
Spring在代码中获取bean的几种方式详解
这篇文章主要介绍了Spring在代码中获取bean的几种方式详解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2019-08-08
web项目WEB-INF下没有web.xml的解决方法
新手如果在web项目创建后WEB-INF下面没有出现web.xml，怎么办？别慌，没有web.xml文件的原因是因为在创建web项目的时候没有把创建web.xml勾上。这篇文章主要介绍了web项目WEB-INF下没有web.xml的解决方法,需要的朋友可以参考下
2022-12-12
全面解析Spring Security 过滤器链的机制和特性
这篇文章主要介绍了Spring Security 过滤器链的机制和特性,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2020-07-07