专栏首页吉吉在这里Git提交信息规范Git Commit Message

Git提交信息规范Git Commit Message

目前规范使用较多的是引用或衍生  Github Angular开发中<提交信息准则>章节(Commit Message Guidelines).以下为规范译文:

关于如何格式化git commit消息,我们有非常精确的规则。这样会有更具可读性的消息,在查看项目历史记录时易于遵循。而且,我们使用git commit消息生成AngularJS更改日志

可以使用典型的git工作流程或使用CLI向导(Commitizen)添加提交消息格式。要使用该向导,yarn run commit 请在对git进行更改后在终端中运行。

提交消息格式

每个提交消息均由信息头(header),正文(body)和页脚(footer)组成。信息头(header)具有一种特殊的格式,包括type(类型),scope(范围)和subject(主题)

<type>(<scope>): <subject>
<BLANK LINE>
<body>
<BLANK LINE>
<footer>

所述信息头(header)是必须的,而信息头范围(scope)的是可选的。

提交消息的任何一行都不能超过100个字符!这使得该消息在GitHub以及各种git工具中更易于阅读。

Revert

如果提交还原了先前的提交,则应以开头revert: ,后跟还原的提交的标头。在正文中应该说:This reverts commit <hash>.,其中哈希是要还原的提交的SHA。

类型(type)

必须为以下之一:

  • feat:一项新功能(feature)
  • fix:一个bug修复
  • docs:仅文档更改
  • style:风格,不影响代码含义的更改(空白,格式,缺少分号等)
  • refactor:重构,既不修正错误也不增加功能的代码更改
  • perf:改进性能的代码改动
  • test:添加缺失或更正现有测试
  • chore:更改构建过程或辅助工具和库,例如文档生成

范围(scope)

范围可以是指定提交更改位置的任何内容。例如$location, $browser$compile$rootScopengHrefngClickngView,等…

当更改影响的范围不止一个范围时,可以使用*(星号)标识。

主题(Subject)

主题简要描述了更改:

  • 使用祈使句式和现在时:“change”而不是“changed”或“changes”
  • 不要大写第一个字母
  • 末尾没有点(。)

正文(Body)

就像在主题中一样,使用祈使句式现在时态:“change”而不是“changed”或“changes”。正文应包括改变的动机,并将其与以前的行为进行对比。

页脚(Footer)

页脚应包含有关Breaking Changes的所有信息,也是参考此提交关闭的GitHub问题的位置 。

重大更改应以BREAKING CHANGE:带有空格或两个换行符的单词开头。然后,将其余的提交消息用于此目的。

详细说明可以在本文档中找到。

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • 5分钟详解chrome浏览器架构知识

    在从事前端开发过程中,浏览器作为最重要的开发环境,浏览器基础是前端开发人员必须掌握的基础知识点,它贯穿着前端的整个网络体系。对浏览器原理的了解,决定...

    薛定喵君
  • Spring Boot 2.X(十四):日志功能 Logback

    Logback 是由 SLF4J 作者开发的新一代日志框架,用于替代 log4j。

    朝雾轻寒
  • 测试开发进阶(三十一)

    使用base64加密之后的header + . + 使用base64加密之后的playload + 使用HS256算法加密,同时secret加盐处理

    zx钟
  • Angular ng-template vs ng-container

    通常情况下,当我们使用结构指令时,我们需要添加额外的标签来封装内容,如使用 *ngIf 指令:

    semlinker
  • 听说这个爬虫面试题很难?看完你就知道怎么做了

    最近(2019年6月)有一个爬虫面试题(http://shaoq.com:7777/exam)在圈内看起来挺火的,经常在各个爬虫群里看到它被提到,而几乎所有提到...

    云爬虫技术研究笔记
  • 讲述前后端分离的区别

    hello,你好,我们今天谈谈前后端为什么分离?其实做javaWeb开发的可能都会经历MVC模式的洗礼,犹新记得前后端的东西都是自己写,好像一个全栈。

    用户3625239
  • 快速学习Jetty-使用Jetty

    进入 官网 页面,可以选择对应的版本下载。可以看到,目前 Jetty 的最新版本是 Jetty9,这里我们使用 9.2。注意:使用 Jetty9.2+ 需要 J...

    cwl_java
  • WordPress SEO:配置Yoast和添加内容目录

    这是我们可以在页面SEO上做的其中一些事情。本系列教程我将介绍丰富的摘录,介绍Google精选摘录,速度优化,图像优化,点击率,本地SEO,以及为什么总是迷恋Y...

    林雍岷
  • ES索引管理工具 - curator

    官方文档:https://www.elastic.co/guide/en/elasticsearch/client/curator/current/action...

    二狗不要跑
  • 当Dubbo遇上Arthas:排查问题的实践

    Arthas是Alibaba开源的应用诊断利器,9月份开源以来,Github Star数三个月超过6000。

    kirito-moe

扫码关注云+社区

领取腾讯云代金券