电子产业一站式赋能平台

PCB联盟网

搜索
查看: 114|回复: 0
收起左侧

常用的 Git 提交规范!

[复制链接]

481

主题

481

帖子

2845

积分

三级会员

Rank: 3Rank: 3

积分
2845
发表于 2024-7-4 11:38:00 | 显示全部楼层 |阅读模式
在我们嵌入式开发中,版本管理工具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.template3、设置commit时使用的编辑器(1)配置全局有效:
git config --global core.editor vim(2)配置当前有效:
git config core.editor vimcommit模板使用git add添加代码到暂存区之后,输入git commit调用模板,使用vim编辑器填写内容。

jvmcypamvyu64012978835.png

jvmcypamvyu64012978835.png

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

lptftz42uyk64012978935.png

lptftz42uyk64012978935.png

比较清晰明了!

猜你喜欢:
最近的项目,选对了一款高性价比的核心板
分享一种灵活性很高的协议格式(附代码例子)
易懂 | 手把手教你编写你的第一个上位机
回复

使用道具 举报

发表回复

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则


联系客服 关注微信 下载APP 返回顶部 返回列表