Git 提交代码时书写多行日志(配置Git commit template)

一、应用场景

  通常我们会采用git commit -m “提交日志” 的方式去提交代码,但是如果我们程序更改的地方很多,那就需要写更多的日志来记录,当我们查看log以后是下面这个样子:(当然也可以在github上去点击查看效果)

这样的提交日志就相对来说很清除,下面就来记录一下实现提交多行日志的方式。

二、配置 Git 提交模板

  1. 在仓库的根目录下新建一个模板文件:如:git_commit_template.txt
  2. git config commit.template git_commit_template.txt    #注意这里文件要加后缀名,该方式设置的是当前分支的提交模板
    git config --global commit.template git_commit_template.txt    #设置的是全局的提交模板。
  3. git config --global core.editor vim    #设置模板的文本编辑器为vim,当然就需要我们在编写日志时会用简单的vim命令。
  4. git commit    #当我们再次提交时直接执行git commit 命令时会进入下图所示的模板界面,我们就可以“任意”书写多行的提交日志了。
      日志模板中会提示当前所处的分支和修改过的文件可以很方便我们去写提交日志。强烈建议使用Git Bash 因为windows的命令行下不支持中文的输入,同时命令行对于高亮的支持也不好。

三、日志模板书写格式

  当然我们可以写多行提交日志也不是随便的写,是有一些通用的格式的,下面部分从网上复制过来的常用的格式可以参考。
  1. 常用格式:

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

  2. 参数要求

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

<body>
Body 部分是对本次 commit 的详细描述,可以分成多行

<footer>
可以根据自己的需要书写。如影响范围等。

四、代码提交

  1. 书写完以后保存退出即可,直接git push 即可。
  2. 提交后可以通过git log 或直接去github 上点击查看效果。

  
  
  
Author: Beyonderwei
Email: beyonderwei@Gmail.com
Website: http://beyonderwei.com
WeChat:

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、付费专栏及课程。

余额充值