🔔 分析
在团队开发中,一般都会使用Git 版本控制工具来管理代码,每个组员提交代码时都会写 commit message。如果没有一个统一标准规范,每个人都有自己的风格,项目小成员少还好,如果团队成员多,项目复杂,十分不利于阅读管理和维护。
通过上方图中提交记录对比,明显感觉上方Git提交记录较为规范美观。虽然本狗写的提交记录也比较清晰,但是随着项目推进及人员的混杂,规范标准必须执行!
因此为了后期一劳永逸,需要制定统一标准,提交记录清晰明了,让团队一看就能知道此次提交的目的,减少管理时间成本。
正文
🥦目标分析
1.IDEA Git描述规范插件?
【git commit message helper】介绍
一个可帮助您标准化提交内容的插件
【git commit message helper】 使用
代码提交时,点击如下图标
补充提交记录
2. Git提交描述格式规范解析
Git提交描述规则可以映射到插件下图部分,Header, Body,Footer
一个规范的Git提交描述格式如下
# Header头
<type>(<scope>): <subject>
# Body体
<body>
# Footer体
<footer>
1.Header头
Header头只有一行,包括3个字段: type(必需), scope(可选), subject(必需)
type 提交类型
type说明提交类型:只允许使用下面属性
scope 作用范围
scope说明提交影响范围:一般是修改的什么模块或者是什么功能,如【xx模块】/【xx功能】
subject 提交主题
subject 说明提交简短描述:一般是5-10各自简单描述做的任务,如【xx模块加入消息队列】
2.Body体
body说明提交详细描述:对于功能详细的描述,解释为什么加入这段代码,为什么调整优化等,如因分布式锁问题,导致死锁问题,优化调整xxxx
3.Footer脚
.Footer脚包括2个字段: Breaking Changes、Closed Issues
Breaking Changes
当前版本与之前版本不兼容,如迭代升级对之前版本不能做到兼容,就需要在Breaking Changes后面描述变动理由和迁移方法之类,此属性不常用
Closed Issues
当前 commit提交针对某个issue问题或者是禅道bug编号等,如Closes # 234
4.完成填充示例
3. 实例Git提交解析
举几个常用git提交描述案例
短信模块新功能提交
用户模块禅道bug1026修复提交
迭代SQL脚本提交