Git commit 消息的格式化

Commit message 的格式

参考:《阮一峰的网络日志:Commit message 和 Change log 编写指南》

每次提交,Commit message 都包括三个部分:Header,Body 和 Footer。

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

注意 冒号后面有空格。

其中,Header 是必需的,Body 和 Footer 可以省略。

不管是哪一个部分,任何一行都不得超过72个字符(或100个字符)。这是为了避免自动换行影响美观。

Header

平时提交时最常用的是只有 Header,这里介绍一下 Header 的使用说明

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

type

type 用于说明 commit 的类别,只允许使用下面7个标识。

feat:新功能(feature)
fix:修补bug
docs:文档(documentation)
style: 格式(不影响代码运行的变动)
refactor:重构(即不是新增功能,也不是修改bug的代码变动)
test:增加测试
chore:构建过程或辅助工具的变动

如果 typefeatfix,则该 commit 将肯定出现在 Change log 之中。其他情况(docschorestylerefactortest)由你决定,要不要放入 Change log,建议是不要。

scope

scope 用于说明 commit 影响的范围,比如 middleware(中间件) 、core(核心) 、config(配置文件) 、plugin(插件) 、test(测试)等等,视项目不同而不同。

subject

subject 是 commit 目的的简短描述,不超过50个字符。

  • 以动词开头,使用第一人称现在时,比如 change,而不是 changedchanges
  • 第一个字母小写
  • 结尾不加句号(.
  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
Git commit template是一个用于规范化git提交信息格式的配置文件。它可以帮助团队成员在提交代码时遵循一致的格式,提高代码提交信息的可读性和可维护性。 要配置git commit template,可以按照以下步骤进行操作: 1. 创建一个模板文件,例如`commit-template.txt`,其中包含了你希望团队成员在提交信息时遵循的格式要求。模板文件可以包含一些固定的信息字段,例如:问题描述、解决方案、变更类型等。你可以根据团队的需求自定义这些字段,并添加相应的注释来指导提交信息的填写。 例如: ``` # 提交类型:[feature|bugfix|refactor|style|docs|test|chore] # # 问题描述: # # 解决方案: # # 关联Issue: ``` 2. 将模板文件添加到git配置中。可以使用以下命令将模板文件路径添加到配置中: ``` git config --global commit.template /path/to/commit-template.txt ``` 其中`/path/to/commit-template.txt`是你创建的模板文件的路径。通过使用`--global`选项,你可以将模板文件应用到所有的git仓库中。 3. 现在,当你使用`git commit`命令提交代码时,会自动打开一个文本编辑器,并显示出你定义的模板文件内容。团队成员可以按照模板中的要求填写提交信息。 如果你想在终端中填写提交信息,可以使用`git commit -t /path/to/commit-template.txt`命令,其中`/path/to/commit-template.txt`是你创建的模板文件的路径。 通过配置git commit template,你可以更加规范化和统一地管理代码提交信息,提高团队协作的效率和质量。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值