百度360必应搜狗淘宝本站头条
当前位置:网站首页 > IT技术 > 正文

常用的Git commit 提交规范!

wptr33 2025-05-14 17:09 10 浏览

在我们嵌入式开发中,版本管理工具Git已经成为不可或缺的一部分。

Git帮助我们记录代码变更历史,提供了强大的代码协作开发功能。

初学时,我们基本都是按照下面的格式这么来写commit信息的吧?

git commit -m "Fix Segmentation fault bug"

甚至有些公司的commit信息也很随意也类似于上面这样的。这样的commit信息包含的信息比较有限,不利于后续的版本追溯。

其实,为了确保团队成员能够更高效地协作,并且保持代码库的整洁和有序,需要团队各成员遵循达成一致的commit提交规范。

commit提交规范尽可能地包含一些能帮助我们对历史版本进行追溯的有用信息。

比如:能清晰地概述所提交的内容、能知道这个提交是bug修复还是功能新增、代码修改的地方、影响范围、是否经过自测等。

这个提交规范可以形成commit模板文件配置到git中。

commit模板配置

1、在用户目录下创建一个名为commit.template的模板文件。模板内容可参考如下:

<类型>: 主题

修改内容:
影响范围:
自测情况:
相关链接:

#1、类型:
# feat:新增 xxx 功能
# fix:修复 xxx bug
# refactor:重构 xxx
# test:测试 xxx
# chore:维护 xxx
# style:变更代码格式、修改注释
# docs:变更 xxx 文档

#2、主题:
# 简单描述本次提交的内容

#3、修改内容:
# 修改了xxx模块/修改了xxx文件/把xxx处理修改为yyy处理等。没有则填无。

#4、影响范围:
# 影响了xxx模块/影响了xxx路径的操作等。没有则填无。

#5、自测情况:
# 测试代码xxx_unit_test.c/测试了xxx路径/待联调测试等。没有则填无。

#6、相关链接:
# 需求链接/bug链接/设计文档链接等。没有则填无。

这个模板只是列举了常用的几个点,仅供参考,可以根据实际需要修改、添加、删除。

2、在git中配置模板

(1)全局使用这个commit message模板

输入如下命令:

git config --global commit.template ~/commit.template

(2)在当前仓库中使用此模板

在当前仓库的根目录下,打开命令行,输入如下命令:

git config commit.template ~/commit.template

3、设置commit时使用的编辑器

(1)配置全局有效:

git config --global core.editor vim

(2)配置当前有效:

git config core.editor vim

commit模板使用

git add添加代码到暂存区之后,输入git commit调用模板,使用vim编辑器填写内容。

保存退出,通过git log查看我们的commit是这样子的:

比较清晰明了!

如果文章对你有帮助,麻烦帮忙点赞、收藏、转发,谢谢!


私信回复【嵌入式书籍】,可获取博主精心整理的嵌入式电子书一份

相关推荐

一篇文章带你了解PHP的学习使用(php的教程)

ThinkPHP5实战...

在memcached管理php的session(memcached libevent)

PHP的session(会话管理)一般是以文件形式进行,而在多个Web服务器之间进行session管理时memecached会比文件管理方式更加方便。在这里介绍如何使用memcached管理PHP的s...

php传值和传引用的区别(php 传值和传引用)

php传值:在函数范围内,改变变量值得大小,都不会影响到函数外边的变量值。PHP传引用:在函数范围内,对值的任何改变,在函数外部也有所体现,因为传引用传的是内存地址。传值:和copy是一样的。【打个比...

PHP 常量详解教程(php常量和变量)

常量类似变量,但是常量一旦被定义就无法更改或撤销定义。PHP常量常量是单个值的标识符(名称)。在脚本中无法改变该值。有效的常量名以字符或下划线开头(常量名称前面没有$符号)。注释:与变量不同,常...

php自学零基础入门小知识(php新手入门教程)

我们就把PHP入门当成一个苹果吧!一口一口的吃掉他!不啰嗦了!开始了1、嵌入方法:类似ASP的<%,PHP可以是<?php或者是<?,结束符号是?>,当然您也可以自己指定。2、...

PHP 语法详解(php语法大全)

PHP脚本在服务器上执行,然后向浏览器发送回纯HTML结果。基础PHP语法PHP脚本可放置于文档中的任何位置。PHP脚本以<?php开头,以?>结尾:<?php...

PHP笔记(一)PHP基础知识(php必背知识点)

创建PHP程序PHP代码框架<?php>2.文件命名规则...

PHP 8新特性之Attributes(注解),你掌握了吗?

PHP8的Alpha版本,过几天就要发布了,其中包含了不少的新特性,当然我自己认为最重要的还是JIT,这个我从2013年开始参与,中间挫折无数,失败无数后,终于要发布的东东。不过,今天呢,我不打算谈J...

PHP基本语法之标记与注释(php注释规范)

1、标记由于PHP是嵌入式脚本语言,它在实际开发中经常会与HTML内容混在一起,所以为了区分HTML与PHP代码,需要使用标记对PHP代码进行标识。如:<html>...

php注解(PHP注解 性能)

目标了解和使用php注解,如果你已经掌握其他一种具有注解的语言,例如:java、python等,你在本文中只需要了解点语法就行。示例php8以前的版本,注解写在注释里,如果你掌握其他语言的注解,你是不...

数据丢失?别慌!MySQL备份恢复攻略

想象一下,某个晴朗的午后,你正享受着咖啡,突然接到紧急电话:你的网站或APP彻底挂了!系统崩溃,界面全白。虽然心头一紧,但你或许还能安慰自己:系统崩溃只是暂停服务,数据还在,修复修复就好了。然而,如果...

MySQL 日志:undo log、redo log、binlog

今天来和大家分享MySQL的三个日志文件,可以说MySQL的多数特性都是围绕日志文件实现,而其中最重要的有以下三种:...

MySQL三大日志:binlog、redolog、undolog全解析

binlog概述在MySQL数据库中,binlog可是个相当重要的存在,它的全称为binarylog,也就是二进制日志。它就像是数据库的“记忆本”,记录了所有的DDL(数据定义语言)和...

1、MySQL数据库介绍(mysql数据库简单介绍)

1.1数据库的核心定义数据库的本质数据库乃存储数据对象之容器,涵盖如下关键组件:表(Table)...

MySQL 日志双雄:实时监控与历史归档实战优化

MySQL日志双雄:实时监控+历史归档实战用这招让你家日志系统再也不卡不爆炸MySQL十亿级日志处理:从洪峰到归档全攻略手把手教你用MySQL搞定ELK级日志监控在微服务架构大行其道的今天,日志系统早...