Git Commit Message 规范实践_git commit message conventions

作者：知新_RL | 2024-05-28 09:17:58

踩

git commit message conventions

背景

本文总结了项目实践中的 Commit Message 规范。

任何一笔提交都是有原因的，因此 commit message 需要说明该笔提交的目的. 我们主要借鉴AngularJS Git Commit Message Conventions。
规范commit message想要达到的目的主要有：

commit message 格式说明，都是必填。
(<issue_id>):

其中 Allowed

<issue_id>: JIRA issue id。比如ANDROID_INFRA-74
: 目前要求是有内容就行。最好不要超过50个字。
: 空行。用来分隔subject和body，分隔body 和 test affect。

: 关于change的相关描述。可以多行，可以包含空行。 : 测试影响说明。必须是关键字“测试影响”开头的一段说明。可以多行，可以包含空行。注意：(): 里面的":"中英文都兼容。

feat(ANDROID_INFRA-90): seperate registration from identity verification

原来的两个接口实现不动，但是标为 Deprecated

新增两个接口：

测试影响：注册和验证流程

feat(ANDROID_INFRA-74): 功能简单描述
<空一行>
<功能具体的具体描述>
实现方法（可选）：
<具体实现方法的描述>
<空一行>
测试影响：
<描述对现有功能的影响，测试需要注意的地方>
<较大新功能和逻辑性较强的功能需要附带部分测试用例>

fix(ANDROID_INFRA-74): 简单描述
<空一行>
<关于Bug的一般说明>
产生原因：
<描述Bug的产生原因>
解决方法：
<描述如何修复bug>
<空一行>
测试影响：
<描述对现有功能的影响，测试需要注意的地方>

refactor(ANDROID_INFRA-74): 重构了什么地方的代码
<空一行>
<对重构内容、目的的相关描述>
所做修改：
<说明你做了那些修改>
<空一行>
测试影响：
<描述对现有功能的影响，测试需要注意的地方>

docs(ANDROID_INFRA-74): 完善xxx文档
<空一行>
<修改原因>
<空一行>
测试影响：
<描述对现有功能的影响，测试需要注意的地方>

test(ANDROID_INFRA-74): 增加xxx方法自动测试案例
<空一行>
<测试详情>
<空一行>
测试影响：
<描述对现有功能的影响，测试需要注意的地方>

style(ANDROID_INFRA-74): check style 修改
<空一行>
<移除了哪些资源和内容>
<空一行>
测试影响：
<描述对现有功能的影响，测试需要注意的地方>

chore(ANDROID_INFRA-74): 完善脚本
<空一行>
<简单介绍>
<空一行>
测试影响：
<描述对现有功能的影响，测试需要注意的地方>

各位可以多次 commit，但是在提交 Merge Request 的时候只能有一次 Commit message，具体操作：

git rebase -i upstream/master

<pick第一次commit>

<squash剩下所有的commit>

<把所有的Commit Message按上述格式融合>

<如果有conflict请解决conflict>

git push origin <your_branch> --force

提交merge request

commit 提交时需要注意一次提交对应一个问题，一来方便大家对此次的提交 code Review ,二来方便后期定期问题，提交时注意规范使用空行及空格（比如中英文之间添加空格、规范使用【】或者「」等，具体可以参考附录5）。

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/知新_RL/article/detail/636743