我的编程空间,编程开发者的网络收藏夹
学习永远不晚

git commit规范的有哪些

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

北京

  • 北京
  • 上海
  • 天津
  • 重庆
  • 河北
  • 山东
  • 辽宁
  • 黑龙江
  • 吉林
  • 甘肃
  • 青海
  • 河南
  • 江苏
  • 湖北
  • 湖南
  • 江西
  • 浙江
  • 广东
  • 云南
  • 福建
  • 海南
  • 山西
  • 四川
  • 陕西
  • 贵州
  • 安徽
  • 广西
  • 内蒙
  • 西藏
  • 新疆
  • 宁夏
  • 兵团
手机号立即预约

请填写图片验证码后获取短信验证码

看不清楚,换张图片

免费获取短信验证码

git commit规范的有哪些

本篇内容介绍了“git commit规范的有哪些”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔细阅读,能够学有所成!

为什么要规范 git commit

一直在说要规范 commit 格式,那为什么要这样做呢?

让我们先来看一个不太规范的 commit 记录:

git commit规范的有哪些

看完什么感觉,写的是啥啊(内心 OS),这种 commit 信息对于想要从中获取有效信息的人来说无疑是一种致命的打击。

那我们来看一个社区里面比较流行的Angular规范的 commit 记录:

git commit规范的有哪些

看完是不是一目了然呢?

上图中这种规范的 commit 信息首先提供了更多的历史信息,方便快速浏览。其次,可以过滤某些 commit(比如文档改动),便于快速查找信息。

既然说到了 Angular 团队的规范是目前社区比较流行的 commit 规范,那它具体是什么呢?下面让我们来具体深入了解下吧。

Angular 团队的 commit 规范

它的 message 格式如下:

<type>(<scope>): <subject>  // 空一行  <body>  // 空一行  <footer>

分别对应 Commit message 的三个部分:Header,Body 和 Footer。

Header

Header 部分只有一行,包括三个字段:type(必需)、scope(可选)和subject(必需)。

  •  type: 用于说明 commit 的类型。一般有以下几种: 

feat: 新增feature    fix: 修复bug    docs: 仅仅修改了文档,如readme.md    style: 仅仅是对格式进行修改,如逗号、缩进、空格等。不改变代码逻辑。    refactor: 代码重构,没有新增功能或修复bug    perf: 优化相关,如提升性能、用户体验等。    test: 测试用例,包括单元测试、集成测试。    chore: 改变构建流程、或者增加依赖库、工具等。    revert: 版本回滚
  •  scope: 用于说明 commit 影响的范围,比如: views, component, utils, test...

  •  subject: commit 目的的简短描述

Body

对本次 commit 修改内容的具体描述, 可以分为多行。如下图:

# body: 72-character wrapped. This should answer:  # * Why was this change necessary?  # * How does it address the problem?  # * Are there any side effects?  # initial commit

Footer

一些备注, 通常是 BREAKING CHANGE(当前代码与上一个版本不兼容) 或修复的 bug(关闭 Issue) 的链接。

简单介绍完上面的规范,我们下面来说一下commit.template,也就是 git 提交信息模板。

git 提交信息模板

如果你的团队对提交信息有格式要求,可以在系统上创建一个文件,并配置 git 把它作为默认的模板,这样可以更加容易地使提交信息遵循格式。

通过以下命令来配置提交信息模板:

git config commit.template   [模板文件名]    //这个命令只能设置当前分支的提交模板  git config  &mdash; &mdash;global commit.template   [模板文件名]    //这个命令能设置全局的提交模板,注意global前面是两杠

新建 .gitmessage.txt(模板文件) 内容可以如下:

# headr: <type>(<scope>): <subject>  # - type: feat, fix, docs, style, refactor, test, chore  # - scope: can be empty  # - subject: start with verb (such as 'change'), 50-character line  #  # body: 72-character wrapped. This should answer:  # * Why was this change necessary?  # * How does it address the problem?  # * Are there any side effects?  #  # footer:  # - Include a link to the issue.  # - BREAKING CHANGE  #

看完上面这些,你会不会像我一样感觉配置下来挺麻烦的,配置一个适合自己和团队使用的近乎完美的 commit 规范看来也不是一件容易的事情。不过社区也为我们提供了一些辅助工具来帮助进行提交,下面来简单介绍一下这些工具。

commitizen(cz-cli)

commitizen是一款可以交互式建立提交信息的工具。它帮助我们从 type 开始一步步建立提交信息,具体效果如图所示:

git commit规范的有哪些

  •   首先通过上下键控制指向你想要的 type 类型,分别对应有上面提到的feat、fix、docs、perf等:   

git commit规范的有哪些

  • 然后会让你选择本次提交影响到的文件:   

git commit规范的有哪些

  • 后面会让你分别写一个简短的和详细的提交描述:   

git commit规范的有哪些

  • 最后会让你去判断本次提交是否是BREAKING CHANGE或者有关联已开启的issue:

git commit规范的有哪些

看完上面的 commitizen 的整个流程,下面让我们来看下如何来安装。

  •  全局环境下安装:

commitizen 根据不同的adapter配置 commit message。例如,要使用 Angular 的 commit message 格式,可以安装cz-conventional-changelog。 

# 需要同时安装commitizen和cz-conventional-changelog,后者是adapter     $ npm install -g commitizen cz-conventional-changelog     # 配置安装的adapter     $ echo '{ "path": "cz-conventional-changelog" }' > ~/.czrc     # 使用     $ git cz
  •  本地项目安装:   

# 安装commitizen     $ npm install --save-dev commitizen     # 接下来安装适配器     # for npm >= 5.2     $ npx commitizen init cz-conventional-changelog --save-dev --save-exact     # for npm < 5.2     $ ./node_modules/.bin/commitizen init cz-conventional-changelog --save-dev --save-exact     // package.json script字段中添加commit命令     "scripts": {        "commit": "git-cz"     }     // use     $ npm run commit

commitlint

commitlint是一个提交验证工具。原理是可以在实际的 git commit 提交到远程仓库之前使用 git 钩子来验证信息。提交不符合规则的信息将会被阻止提交到远程仓库。

先来看一下演示:

git commit规范的有哪些

对于 Conventional Commits 规范,社区已经整理好了 @commitlint/config-conventional 包,我们只需要安装并启用它就可以了。

首先安装 commitlint 以及 conventional 规范:

npm install --save-dev @commitlint/cli @commitlint/config-conventional

接着在 package.json 中配置 commitlint 脚本:

"commitlint": {      "extends": [        "@commitlint/config-conventional"      ]    },

当然如果你想单独对 commitlint 进行配置的话,需要建立校验文件 commitlint.config.js,不然会校验失败

为了可以在每次 commit 时执行 commitlint 来 检查我们输入的 message,我们还需要用到一个工具 &mdash;&mdash; husky。

husky 是一个增强的 git hook 工具。可以在 git hook 的各个阶段执行我们在 package.json 中配置好的 npm script。

首先安装 husky:

npm install --save-dev husky

接着在 package.json 中配置 commitmsg 脚本:

"husky": {      "hooks": {        "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"      }   },

到这里,commitlint就配置完成了~

gitmoji-cli

平时与朋友聊天时,我们一定会用到表情包,比如。表情包的出现让我们与朋友之间的沟通变得更加有趣。如果能在 git 提交 commit 时用到表情包(),岂不是使每次的 commit 能够更加直观,维护起来也更加方便。

git commit规范的有哪些

gitmoji就是可以实现这种功能的插件,先让我们来感受一下

有没有感觉很 cool~~

其实gitmoji的使用是很简单的:

# 安装  npm i -g gitmoji-cli  # 使用  git commit -m ':bug: 问题fix'

我们来看一下官方的示例吧:

git commit规范的有哪些

“git commit规范的有哪些”的内容就介绍到这里了,感谢大家的阅读。如果想了解更多行业相关的知识可以关注编程网网站,小编将为大家输出更多高质量的实用文章!

免责声明:

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

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

git commit规范的有哪些

下载Word文档到电脑,方便收藏和打印~

下载Word文档

猜你喜欢

Git 使用规范有哪些

本篇文章为大家展示了Git 使用规范有哪些,内容简明扼要并且容易理解,绝对能使你眼前一亮,通过这篇文章的详细介绍希望你能有所收获。第一步:新建分支首先,每次开发新功能,都应该新建一个单独的分支(这方面可以参考《Git分支管理策略》)。# 获
2023-06-04

git下commit和push的区别有哪些

这篇文章主要介绍git下commit和push的区别有哪些,文中介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们一定要看完!区别:“git commit”命令是将本地修改过的文件提交到本地库中,而“git push”命令是将本地库中的最
2023-06-21

codereview规范有哪些

Code Review的规范可以有很多,这里列举一些常见的规范:代码风格一致性:确保代码使用统一的缩进风格、命名规范、空格使用、代码注释等。功能实现正确性:确认代码实现了预期的功能,没有逻辑错误和漏洞。代码质量:评估代码的可读性、可维护
2023-10-21

Redis规范有哪些

这篇“Redis规范有哪些”文章的知识点大部分人都不太理解,所以小编给大家总结了以下内容,内容详细,步骤清晰,具有一定的借鉴价值,希望大家阅读完这篇文章能有所收获,下面我们一起来看看这篇“Redis规范有哪些”文章吧。redis 功能强大,
2023-06-27

git查看commit修改的方法有哪些

本文小编为大家详细介绍“git查看commit修改的方法有哪些”,内容详细,步骤清晰,细节处理妥当,希望这篇“git查看commit修改的方法有哪些”文章能帮助大家解决疑惑,下面跟着小编的思路慢慢深入,一起来学习新知识吧。首先,让我们了解一
2023-07-05

Golang的命名规范有哪些

本篇内容介绍了“Golang的命名规范有哪些”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔细阅读,能够学有所成!很少见人总结一些命名规范,也可能是笔者孤陋寡闻,
2023-06-22

C#的命名规范有哪些

本篇内容主要讲解“C#的命名规范有哪些”,感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷,实用性强。下面就让小编来带大家学习“C#的命名规范有哪些”吧!C#项目开发实例中,对于规范的制定,是很重要的要求。合理的方法名,合适的命名都是C#
2023-06-17

编程热搜

目录