当前位置: 首页 > news >正文

别再乱写git commit了

B站|公众号:啥都会一点的研究生

写在前面

在很长的一段时间中,使用git commit都是随心所欲,log肥肠简洁,随着代码的迭代,当时有多偷懒,返过头查看git日志就有多懊悔,就和写代码不写doc string或写的很简单一样,将浪费无数时间重新浏览

其实,git commit格式是有约定的,以下对一些常用进行说明,一起看看吧

正文

提交commit的结构如下

<type>[optional scope]: <description>[optional body][optional footer(s)]
type

首先是type,必填项能直观的向向各使用者传达进行了哪类型的更新,一般使用较多的为

  • fix:用于表明修复了代码库中的bug
  • feat:在代码库中新增了功能

此外,还有一些其他类型

  • perf:在不影响代码内部行为的情况下进行了优化,提升性能
  • refactor:代码重构
  • docs:只修改了文档类型的内容
  • style:不影响代码含义的修改,如删除空格等
  • test:测试用例的新增或修改
  • build:项目构建或依赖进行更新
  • revert:一种特殊情况,如果当前commit用于撤销以前的commit,则必须用该type,后面跟着被撤销commit的Header。
  • ci:与 CI(持续集成服务)有关的改动,如GitLab CI
  • chore:其他修改

很多人不知道的是这些type后可以搭配!用于向使用者表明本次更新较为重要,如feat!: <description>

scope

再是scope,选填,用于阐明本次commit 影响的范围,如与数据预处理相关、某模块功能相关等

description

必填,顾名思义就是对本次的提交做个简短概述

  • 以动词开头,使用现在时如fix,而不是fixed
  • 第一个字母小写
  • 结尾不加句号(.)
body

选填,详细描述本次的commit,一般小的修改在上面description即可描述清楚,而重大更新尽量把body写的详尽,可分行

footer

一般只涉及BREAKING CHANGE和ISSUE相关

  • BREAKING CHANGE:比如涉及重大变更则本部分为必填项,类似版本升级、接口变更等
  • ISSUE相关:如当前 commit 针对某个issue,可进行引用/关闭

以下参考www.conventionalcommits.org

例子

  • 带有description和 breaking change footer的commit
feat: allow provided config object to extend other configsBREAKING CHANGE: `extends` key in config file is now used for extending other config files
  • 使用!提交消息以引起对重大更改的注意
feat!: send an email to the customer when a product is shipped
  • 提交带有范围和!的消息
feat(api)!: send an email to the customer when a product is shipped
  • 提交带有!和BREAKING CHANGE footer的消息
chore!: drop support for Node 6BREAKING CHANGE: use JavaScript features not available in Node 6.
  • 提交没有正文的消息
docs: correct spelling of CHANGELOG
  • 提交具有多段落body和多个footer的消息
fix: prevent racing of requestsIntroduce a request id and a reference to latest request. Dismiss
incoming responses other than from latest request.Remove timeouts which were used to mitigate the racing issue but are
obsolete now.Reviewed-by: Z
Refs: #123

约定规范

  • commit必须以type为前缀,类型由名词(例如feat表示新功能,fix表示修复等)组成,后面是可选的范围(scope),可选的感叹号(!),和必需的冒号(英文半角)和空格

  • commit后可以提供范围(scope),必须由括号括起的描述代码库部分的名词组成,例如fix(parser)

  • 冒号和类型/范围前缀之后必须立即跟着描述(description),描述是代码更改的简短摘要

  • 在简短描述之后,可以提供较长的正文(body)描述,提供有关代码更改的详细上下文信息。正文必须在description之后的一个空行处开始。

  • body是自由格式的,可以由任意数量的用换行符分隔的段落组成

  • 在正文结束的一个空行之后,可以编写一行或多行脚注(footer)。脚注必须包含关于提交的元信息,例如:关联的合并请求、ISSUE相关、重大变更,每条元信息一行

  • 破坏性变更必须标示在正文区域最开始处,或脚注区域中某一行的开始

  • 如果将破坏性变更写在脚注中,必须包含大写文本BREAKING CHANGE,后面紧跟冒号、空格和相关描述,例如BREAKING CHANGE: environment variables now take precedence over config files.

  • 如果破坏性变更写在正文,必须在冒号前加上!,如果使用!则可以从脚注部分省略BREAKING CHANGE: ,并且提交描述将用于描述破坏性更改

以上就是本期的全部内容,期待点赞在看,我是啥都生,下次再见

相关文章:

别再乱写git commit了

B站|公众号&#xff1a;啥都会一点的研究生 写在前面 在很长的一段时间中&#xff0c;使用git commit都是随心所欲&#xff0c;log肥肠简洁&#xff0c;随着代码的迭代&#xff0c;当时有多偷懒&#xff0c;返过头查看git日志就有多懊悔&#xff0c;就和写代码不写doc string…...

八大排序(一)冒泡排序,选择排序,插入排序,希尔排序

一、冒泡排序 冒泡排序的原理是&#xff1a;从左到右&#xff0c;相邻元素进行比较。每次比较一轮&#xff0c;就会找到序列中最大的一个或最小的一个。这个数就会从序列的最右边冒出来。 以从小到大排序为例&#xff0c;第一轮比较后&#xff0c;所有数中最大的那个数就会浮…...

泊松分布简要介绍

泊松分布是一种常见的离散概率分布&#xff0c;它用于描述某个时间段或区域内随机事件发生的次数。它得名于法国数学家西蒙丹尼泊松。 泊松分布的概率质量函数表示某个时间段或区域内事件发生次数的概率。如果随机变量 X 服从泊松分布&#xff0c;记作 X ~ Poisson(λ)&#x…...

C语言每日一题(10):无人生还

文章主题&#xff1a;无人生还&#x1f525;所属专栏&#xff1a;C语言每日一题&#x1f4d7;作者简介&#xff1a;每天不定时更新C语言的小白一枚&#xff0c;记录分享自己每天的所思所想&#x1f604;&#x1f3b6;个人主页&#xff1a;[₽]的个人主页&#x1f3c4;&#x1f…...

VSCode开发go手记

断点调试&#xff1a; 安装delve&#xff08;windows&#xff09;&#xff1a; go get -u github.com/go-delve/delve/cmd/dlv 设置 launch.json 配置文件&#xff1a; ctrlshiftp 输入 Debug: Open launch.json 打开 launch.json 文件&#xff0c;如果第一次打开,会新建一…...

怎么选择AI伪原创工具-AI伪原创工具有哪些

在数字时代&#xff0c;创作和发布内容已经成为了一种不可或缺的活动。不论您是个人博主、企业家还是网站管理员&#xff0c;都会面临一个共同的挑战&#xff1a;如何在互联网上脱颖而出&#xff0c;吸引更多的读者和访客。而正是在这个背景下&#xff0c;AI伪原创工具逐渐崭露…...

【块状链表C++】文本编辑器(指针中 引用 的使用)

》》》算法竞赛 /*** file * author jUicE_g2R(qq:3406291309)————彬(bin-必应)* 一个某双流一大学通信与信息专业大二在读 * * brief 一直在竞赛算法学习的路上* * copyright 2023.9* COPYRIGHT 原创技术笔记&#xff1a;转载…...

echarts的Y轴设置为整数

场景&#xff1a;使用echarts&#xff0c;设置Y轴为整数。通过判断Y轴的数值为整数才显示即可 yAxis: [{name: ,type: value,min: 0, // 最小值// max: 200, // 最大值// splitNumber: 5, // 坐标轴的分割段数// interval: 100 / 5, // 强制设置坐标轴分割间隔度(取本Y轴的最大…...

恢复删除文件?不得不掌握的4个方法!

“删除了的文件还可以恢复吗&#xff1f;有个文件我本来以为不重要了&#xff0c;就把它删除了&#xff0c;没想到现在还需要用到&#xff01;这可怎么办&#xff1f;有没有办法找回来呢&#xff1f;” 重要的文件一旦丢失或误删可能都会对我们的工作和学习造成比较大的影响。怎…...

GitLab CI/CD:.gitlab-ci.yml 文件常用参数小结

文章目录 一、.gitlab-ci.yml 文件作用二、一个简单的.gitlab-ci.yml 文件示例参考 一、.gitlab-ci.yml 文件作用 可以定义跑CI时想要运行的命令或脚本 可以定义job之间的依赖和缓存 可以执行程序部署并定义部署位置 可以定义想要包含的其他配置文件和模版 二、一个简单的.gi…...

MySQL学习笔记9

MySQL数据表中的数据类型&#xff1a; 在考虑数据类型、长度、标度和精度时&#xff0c;一定要仔细地进行短期和长远的规划&#xff0c;另外&#xff0c;公司制度和希望用户用什么方式访问数据也是要考虑的因素。开发人员应该了解数据的本质&#xff0c;以及数据在数据库里是如…...

从零学习开发一个RISC-V操作系统(三)丨嵌入式操作系统开发的常用概念和工具

本篇文章的内容 一、嵌入式操作习系统开发的常用概念和工具1.1 本地编译和交叉编译1.2 调试器GDB&#xff08;The GNU Project Debugger&#xff09;1.3 QEMU模拟器1.4 项目构造工具Make 本系列是博主参考B站课程学习开发一个RISC-V的操作系统的学习笔记&#xff0c;计划从RISC…...

小米机型解锁bl 跳“168小时”限制 操作步骤分析

写到前面的安全提示 了解解锁bl后的风险&#xff1a; 解锁设备后将允许修改系统重要组件&#xff0c;并有可能在一定程度上导致设备受损&#xff1b;解锁后设备安全性将失去保证&#xff0c;易受恶意软件攻击&#xff0c;从而导致个人隐私数据泄露&#xff1b;解锁后部分对系…...

基础练习 回文数

问题描述 1221是一个非常特殊的数&#xff0c;它从左边读和从右边读是一样的&#xff0c;编程求所有这样的四位十进制数。 输出格式 按从小到大的顺序输出满足条件的四位十进制数。 solution1 #include <stdio.h> int main(){int n 1000, n1, n2, n3, n4;while(n &…...

解决Spring Boot 2.7.16 在服务器显示启动成功无法访问问题:从本地到服务器的部署坑

&#x1f337;&#x1f341; 博主猫头虎 带您 Go to New World.✨&#x1f341; &#x1f984; 博客首页——猫头虎的博客&#x1f390; &#x1f433;《面试题大全专栏》 文章图文并茂&#x1f995;生动形象&#x1f996;简单易学&#xff01;欢迎大家来踩踩~&#x1f33a; &a…...

洛谷P5661:公交换乘 ← CSP-J 2019 复赛第2题

【题目来源】https://www.luogu.com.cn/problem/P5661https://www.acwing.com/problem/content/1164/【题目描述】 著名旅游城市 B 市为了鼓励大家采用公共交通方式出行&#xff0c;推出了一种地铁换乘公交车的优惠方案&#xff1a; 1.在搭乘一次地铁后可以获得一张优惠票&…...

mysql优化之索引

索引官方定义&#xff1a;索引是帮助mysql高效获取数据的数据结构。 索引的目的在于提高查询效率&#xff0c;可以类比字典。 可以简单理解为&#xff1a;排好序的快速查找数据结构 在数据之外&#xff0c;数据库系统还维护着满足特定查找算法的数据结构&#xff0c;这种数据…...

文件系统详解

目录 文件系统&#xff08;1&#xff09; 第一节文件系统的基本概念 一、文件系统的任务 二、文件的存储介质及存储方式 三、文件的分类 第二节 文件的逻辑结构和物理结构 一、文件的逻辑结构 二、文件的物理结构 文件系统&#xff08;2&#xff09; 第三节 文件目…...

有名管道及其应用

创建FIFO文件 1.通过命令&#xff1a; mkfifo 文件名 2.通过函数: mkfifo #include <sys/types.h> #include <sys/stat.h> int mkfifo(const char *pathname, mode_t mode); 参数&#xff1a; -pathname&#xff1a;管道名称的路径 -mode&#xff1a;文件的权限&a…...

加州大学伯克利分校 计算机科学专业

加州大学伯克利分校 计算机科学专业 cs 61a cs 61b cs61c...

GPLT L3-042 ‘污染大亨’暴力DFS只拿1分?聊聊竞赛中‘优化剪枝’的思维起点与常见误区

从暴力DFS到优化剪枝&#xff1a;竞赛选手的算法思维跃迁指南 在程序设计竞赛中&#xff0c;我们常常会遇到这样的困境&#xff1a;面对一道看似只能暴力解决的题目&#xff0c;提交后却只得到可怜的1分。这就像原文作者在GPLT L3-042"污染大亨"题中的遭遇——一个简…...

俄罗斯电商经营风险高?Captain AI为你的出海之路兜底

俄罗斯电商市场的红利很可观&#xff0c;但背后的经营风险也无处不在&#xff1a;平台合规风险、税务稽查风险、外汇管制风险、清关风险、知识产权风险、资金安全风险&#xff0c;任何一个风险点爆发&#xff0c;都可能让你之前所有的努力付诸东流——轻则面临高额罚款、货物没…...

【车载C#中控系统开发黄金法则】:20年一线专家亲授5大避坑指南与实时响应优化秘技

第一章&#xff1a;车载C#中控系统开发的实时性本质与架构约束车载C#中控系统并非通用桌面应用的简单移植&#xff0c;其核心挑战源于汽车电子环境对确定性响应、资源隔离与功能安全的刚性要求。实时性在此语境下并非指微秒级硬实时&#xff08;如ECU控制&#xff09;&#xff…...

从零开始构建Kaggle Python Docker镜像:开发者完整教程

从零开始构建Kaggle Python Docker镜像&#xff1a;开发者完整教程 【免费下载链接】docker-python Kaggle Python docker image 项目地址: https://gitcode.com/gh_mirrors/do/docker-python Kaggle Python Docker镜像为数据科学家和开发者提供了一个预配置的环境&…...

ggplot2实战:解决geom_histogram频率分布直方图binwidth调整引发的密度计算异常

1. 直方图密度计算异常现象解析 第一次用ggplot2画频率分布直方图时&#xff0c;我盯着屏幕上那些超过1的百分比数值愣了半天——这明显违背了概率的基本定义。后来发现这是很多R语言新手都会遇到的经典问题&#xff1a;当调整geom_histogram的binwidth参数时&#xff0c;使用.…...

毫米波雷达避坑指南:IWR1443做手势识别时,为什么速度解模糊是关键一步?

毫米波雷达手势识别实战&#xff1a;破解IWR1443速度模糊难题的核心策略 当你在IWR1443毫米波雷达上实现手势控制时&#xff0c;是否遇到过这样的困扰——快速挥手动作导致系统识别轨迹突然跳变&#xff1f;这背后隐藏着一个关键的技术瓶颈&#xff1a;速度模糊问题。本文将深入…...

强化学习基础与实践:从理论到应用

强化学习基础与实践&#xff1a;从理论到应用 1. 背景介绍 强化学习&#xff08;Reinforcement Learning&#xff0c;RL&#xff09;是机器学习的一个重要分支&#xff0c;它关注的是智能体&#xff08;Agent&#xff09;如何在环境中通过与环境的交互学习最优行为策略&#…...

Qt窗口管理:深入解析close与hide函数的应用场景与性能影响

1. Qt窗口管理基础&#xff1a;理解close与hide的核心差异 刚开始接触Qt开发时&#xff0c;我也曾被close()和hide()这两个看似相似的函数搞糊涂过。直到有次在项目中错误使用了close()导致整个界面崩溃&#xff0c;才真正意识到它们的本质区别。简单来说&#xff0c;hide()就像…...

Go语言SQL构建器goqu与标准库sql对比:为什么选择SQL构建器的完整指南

Go语言SQL构建器goqu与标准库sql对比&#xff1a;为什么选择SQL构建器的完整指南 【免费下载链接】goqu SQL builder and query library for golang 项目地址: https://gitcode.com/gh_mirrors/go/goqu 在Go语言开发中&#xff0c;数据库操作是每个后端开发者必须面对的…...

Linux 线程:从虚拟地址空间到 POSIX 线程控制全解析

前言在 Linux 系统编程与操作系统原理中&#xff0c;线程是并发执行的核心单元&#xff0c;而虚拟地址空间与分页机制是线程共享资源、轻量化运行的底层基石。本文将从线程本质、内存管理原理、进程线程对比、POSIX 线程控制、地址空间布局到线程封装&#xff0c;层层拆解 Linu…...