文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

规范GIT代码提交信息和自动化版本管理的方法

2023-06-27 10:57

关注

本篇内容介绍了“规范GIT代码提交信息和自动化版本管理的方法”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔细阅读,能够学有所成!

前言

git作为一个开发人员必不可少的工具,代码提交也是日常一个非常频繁的操作,如果你或你的团队目前对提交信息还没有一个规范或约束,那么你有必要看看本文的内容了。

为什么要规范提交信息

首先规范提交信息肯定是有必要的,简单总结下几点好处:

使用什么规范

Conventional Commits(约定式提交规范),是目前使用最广泛的提交信息规范,其主要受AngularJS规范 的启发,下面是一个规范信息的结构:

[optional scope]: //空一行[optional body]//空一行[optional footer(s)]

规范说明

type 提交的类别,必须是以下类型中的一个

feat:增加一个新功能fix:修复bugdocs:只修改了文档style:做了不影响代码含义的修改,空格、格式化、缺少分号等等refactor:代码重构,既不是修复bug,也不是新功能的修改perf:改进性能的代码test:增加测试或更新已有的测试chore:构建或辅助工具或依赖库的更新

scope 可选,表示影响的范围、功能、模块

subject必填,简单说明,不超过 50个字

body选填,用于填写更详细的描述

footer选填,用于填关联issus,或BREAK CHANGE

BREAKING CHANGE

必须是大写,表示引入了破坏性 API 变更,通常是一个大版本的改动,BREAKING CHANGE: 之后必须提供描述,下面一个包含破坏性变更的提交示例

feat: allow provided config object to extend other configsBREAKING CHANGE: `extends` key in config file is now used for extending other config files

更详细的说明请看约定式提交规范

如何约束规范

怎么确保每个提交都能符合规范呢,最好的方式就是通过工具来生成和校验,commitizen是一个nodejs命令行工具,通过交互的方式,生成符合规范的git commit,界面如下:

规范GIT代码提交信息和自动化版本管理的方法

开始安装:

# 全局安装npm install -g commitizen # 或者本地安装$ npm install --save-dev commitizen# 安装适配器npm install cz-conventional-changelog

packages.json在配置文件中指定使用哪种规范

...  "config": {    "commitizen": {      "path": "cz-conventional-changelog"    }  }

安装完成后可以使用git cz 来代替git commit,然后根据提示一步步输入即可

格式校验commitlint

可能你不想每次都通过交互界面来生成,还是想使用git commit -m 'message',那么为了确保信息的正确性,可以结合husky对提交的信息进行格式验证

安装依赖

npm install --save-dev @commitlint/{config-conventional,cli}# 安装huskynpm install --save-dev husky

添加 commitlint.config.js文件到项目

echo "module.exports = {extends: ['@commitlint/config-conventional']}" > commitlint.config.js``` `package.json`配置#git提交验证“husky”: {“hooks”: {“commit-msg”: “commitlint -E HUSKY_GIT_PARAMS”}},

OK到这一步就完成了,最后给你项目 README.MD 加上一个commitizen-friendly的标识吧

规范GIT代码提交信息和自动化版本管理的方法

[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg) _blank](http://commitizen.github.io/cz-cli/)## 自动版本管理和生成CHANGELOG规范化的提交信息除了能很好描述项目的修改,还有一个很好的作用就是能根据提交记录来生成CHANGELOG.MD和自动生成版本号等功能。### standard-version一个用于生成`CHANGELOG.md`和进行`SemVer(语义化版本号)`发版的命令行工具主要功能:* 自动修改最新版本号,可以是`package.json`或者自定义一个文件* 读取最新版本号,创建一个最新的`git tag`* 根据提交信息,生成`CHANGELOG.md`* 创建一个新提交包括 `CHANGELOG.md`和`package.json`### 语义化版本控制(SemVer)先简单了解下什么是语义化的版本控制,其是由`GitHub`发起的一份用于规范版本号递增的规则,##### 版本格式主版本号.次版本号.修订号,版本号递增规则如下:* 主版本号(major):当你做了不兼容的 API 修改,* 次版本号(minor):当你做了向下兼容的功能性新增,可以理解为Feature版本,* 修订号(patch):当你做了向下兼容的问题修正,可以理解为Bug fix版本。先行版本号可以加到“主版本号.次版本号.修订号”的后面,作为延伸。##### 先行版本当即将发布大版本改动前,但是又不能保证这个版本的功能 100% 正常,这个时候可以发布先行版本:* alpha: 内部版本* beta: 公测版本* rc: 候选版本(Release candiate)比如:1.0.0-alpha.0,1.0.0-alpha.1,1.0.0-rc.0,1.0.0-rc.1等。 `standard-version` 会根据提交的信息类型来自动更改对应的版本号,如下:* feat: 次版本(minor)+1* fix: 修订号(patch) +1* BREAK CHANGE: 主板号(marjor) +1> `standard-verstion` 生成的`CHANGELOG`只会包含`feat`,`fix`,`BREACK-CHANGE`类型的提交记录#### 使用``` bashnpm i --save-dev standard-version

添加npm script

{ scripts:{   "release": "standard-version",   "release:alpha": "standard-version --prerelease alpha",   "release:rc": "standard-version --prerelease rc"  }}

执行:

# npm run scriptnpm run release# or global binstandard-version

或者你想指定发行版本号:

#指定类型 patch/minor/marjornpm run release -- --release-as patch#指定版本号npm run release -- -- release-as 1.1.0
生命周期

standard-version本身只针对本地,并没有push才操作,我们可以在最后一步生成 tag 后,执行 push 操作,在paceage.json中添加

"standard-version": {    "scripts": {      "posttag": "git push --follow-tags origin master && npm publish"    }  }

还有更多配置功能自行查阅 官方文档

其它类似工具

除了standard-version,还有其它类似的工具,有兴趣可以去了解下

修改Git Commit

为了使CHANGELOG.MD更能加直观看到每个版本的修改,我们尽量保证每次提交都是有意义的,但实际开发过程中,不可避免会提交了一些错误的 commit message,下面介绍几个git命令来修改commit

1 修改最后一次提交

git commit --amend

该命令会创建一个提交并覆盖上次提交,如果是因为写错或者不满意上次的提交信息,使用该命令就非常适合。

2 合并多条提交

git reset --soft [commitID]

如果你想合并最近几条提交信息的话,那么就需要使用上面的命令来操作,指定要撤销的 ccommitId ,该命令会保留当前改动并撤销指定提交后的所有commit记录,如果不指定ID的话可以使用HEAD~{num} 来选择最近{num}条提交

git reset --soft HEAD~2 #合并最近两条提交git commit -m 'feat: add new feat'

--soft 参数的区别在于把改动内容添加到暂存区 相当于执行了git add .

git rebase -i

git rebase的功能会更加强大,如果我想修改最近3条提交记录,执行

git rebase -i  HEAD~3

会出现如下编辑器界面(vim编辑器):

规范GIT代码提交信息和自动化版本管理的方法

上面显示的是我最近 3条提交信息 ,下面是命令说明,修改方式就是将 commit 信息前的pick改为你需要的命令,然后退出:wq保存

下面是常用的命令说明:

p,pick = 使用提交r,reword = 使用提交,但修改提交说明e,edit = 使用提交,退出后使用git commit --amend 修改s,squash = 使用提交,合并前一个提交f,fixup = 和squash相同,但丢弃提交说明日志d,drop = 删除提交,丢弃提交记录

“规范GIT代码提交信息和自动化版本管理的方法”的内容就介绍到这里了,感谢大家的阅读。如果想了解更多行业相关的知识可以关注编程网网站,小编将为大家输出更多高质量的实用文章!

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     807人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     351人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     314人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     433人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     221人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯