Git Commit Message规范

这篇具有很好参考价值的文章主要介绍了Git Commit Message规范。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

概述

Git commit message规范是一种良好的实践,可以帮助开发团队更好地理解和维护代码库的历史记录。它可以提高代码质量、可读性和可维护性。下面是一种常见的Git commit message规范,通常被称为"Conventional Commits"规范:

一、Commit message 的格式

每次提交,Commit message 都包括三个部分:HeaderBodyFooter

<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:构建过程或辅助工具的变动

补充:

  • chore: 构建工具、辅助工具或其他无关紧要的任务
  • perf: 改进性能的代码更改
  • revert: 撤销以前的提交

(2)scope

scope用于说明 commit 影响的范围,比如指标模板、规则上下线等等,视项目不同而不同。

(3)subject

subjectcommit 目的的简短描述,不超过50个字符。

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

1.2 Body

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

  1. 需要简要的列出各种正向或者反向的测试场景,测试通过,填pass。
  2. 关闭的Issue(References) (可选): 如果此提交与某个问题(Issue)相关联,可以在提交消息中引用该问题。例如,Fixes #123Closes #456
  3. 增加修改人信息

二、例子

2.1 feat例子

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

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

提交人:xxx

2.2 fix例子

fix(模型模块): 模型测试失败
 
1. 导入mar模型,包含衍生字段。 pass
2. 导入mar模型,不包含衍生字段。 pass
 
提交人:xxx

2.3 关闭的Issue例子

feat(auth): add user authentication feature

- Implemented user login and registration
- Added user profile page
- Fixes #123, Closes #456

提交人:xxx

使用这种规范的好处在于,它使提交消息更加一致和易于搜索。同时,它还允许自动化工具从提交消息中提取信息,如生成发布日志或自动化版本号管理。

插件推荐

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

1、安装插件

git message规范,git

2、提交时选择插件提交

git message规范,git

git message规范,git

参考

Git Commit Message规范
https://blog.csdn.net/LBWNB_Java/article/details/126776372文章来源地址https://www.toymoban.com/news/detail-850527.html

到了这里,关于Git Commit Message规范的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • 《Git常用命令》详细讲解·第4篇(git commit -m “commit message“和git commit --amend)

    提交所有更新 提交所有更新过的文件——git commit -m “commit message” 是一个Git命令,用于将暂存区的更改提交到本地仓库。 -m 选项后面跟着的是本次提交的描述信息,即commit message。这个信息应该清晰地表明所做的更改。 示例: 提交更改到本地仓库: 在这个例子中,我们提

    2024年04月28日
    浏览(36)
  • (极简解决)git commit 时出现:please enter the commit message for your changes

    很多小白当使用git commit命令后,出现了这个框,而且按其他按键都没有反应的时候,肯定会有很多小白开始慌了。 原因分析:是对commit语句不熟练,或者对日志不习惯导致的。弹出这个框(文本编辑)的原因是因为更改这个文件提交后并没有做出备注,如果使用git commit -m

    2024年02月13日
    浏览(41)
  • 【git push ERROR: commit id: missing Change-Id in message footer】

    使用 gerrit 后,提交代码会出现如下截图问题: 临时解决: step1: 把上面红色的那条gitidir复制下来执行下: step2:执行下面的命令会添加change_id step3: 然后推送代码到服务器上 上面这个情况 主要针对本地刚下载的仓库 , 第一次提交会出现这个情况 ,只需要执行一次,以后再

    2024年04月22日
    浏览(34)
  • git commit遇到with ‘#‘ will be ignored, and an empty message aborts the commit.或git log失败的原因及两种解决方案。

    git add与commit操作已经搞完了,git log碰到下面的问题 或者 git提交时,使用了git commit 文件名 时弹出了以下窗口  文段翻译过来的大意为: 请为本次修改键入commit命令的相关消息,以#开头的行被挡住注释(被忽略),一个空的消息(啥都不输入)将视为放弃本次commit提交。 1、改用

    2024年02月16日
    浏览(40)
  • 解决Git提交代码报错: ERROR: commit xxxxx: missing Change-Id in message footer

    在近期的工作中完成代码修改提交代码时Git报错并提示提交不成功,具体错误如下:  原因是Change-Id缺失。至于解决方法,Git在报错时已经提示了,如下图黄框所示: 首先,复制命令  gitdir=$(git rev-parse --git-dir); scp -p -P 29418 lijunlin@192.168.64.47:hooks/commit-msg ${gitdir}/hooks/ 并执行

    2024年02月05日
    浏览(42)
  • 解决git提交:Please enter a commit message to explain why this merge is necessary

    使用git提交代码在本次提交时已有其他人提交过代码,报如下信息: 解决输入 键盘输入‘i’ 键盘输入‘esc’ 键盘输入‘:wq’ 键盘输入‘enter’, 提交代码成功

    2024年02月11日
    浏览(34)
  • git merge合并分支代码# Please enter a commit message to explain why this merge is necessar У git退出编辑信息

    git合并代码遇到问题(一般都是正常的合并行为在MacBook上面出现操作) 首先输入完git merge 分支名 后会出现这样的提示,先说流程,再说原因 ①:出现上图提示后,英文状态下按 i 键,这时候会进入insert(插入)模式; ②:然后就可以输入提交信息了,可以把第一行删除,

    2024年02月09日
    浏览(31)
  • Git 合并时出现 Please enter a commit message to explain why this merge is necessary 问题解决

    大概的意思如下: 1. 按键盘字母 i 进入insert 模式; 2. 修改最上面那行黄色合并信息,也可以不修改; 3. 按键盘左上角\\\"Esc\\\"键; 4. 输入\\\":wq\\\",注意是冒号+wq,按回车键即可;

    2024年02月01日
    浏览(33)
  • git commit 提交规范

    大致分为三个部分(使用空行分割): 标题行: 描述主要修改类型和内容 主题内容 页脚注释: 放 Breaking Changes 或 Closed Issues type commit 的类型: feat: 新功能、新特性 fix: 修改 bug perf: 更改代码,以提高性能(在不影响代码内部行为的前提下,对程序性能进行优化) refactor: 代码重构

    2024年01月18日
    浏览(43)
  • [git] 规范Commit格式

    Jenkins 根据对比当次构建和上次构建的Commit信息来生成 ChangeLog ,但因为我们目前的提交不够规范,经常有类似\\\"#\\\",\\\"update\\\"这列的提交,无法提供给PM有效的更新记录,所以建议大家尽量规范Commit格式。 目前推荐大家是有这套规范,如果大家有更好的可以推荐使用,官网链接如下

    2023年04月14日
    浏览(36)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包