Git message提交模板

时间 2019-11-21

标签 git message 提交模板栏目 Git 繁體版

原文原文链接

不谈使用git message模板的缘由或者历史，网上有一堆。相信针对看到这文章的人都知道，目前本身的版本管理中，追溯提交日志时以为信息凌乱甚至不堪入目。所以才有此想法：统一提交模板

1. 模板格式

规范使用较多的是 Angular 团队的规范，格式以下：css

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

type: commit 的类型（必填）git

feat: 新特性
fix: 修改问题
refactor: 代码重构
docs: 文档修改
style: 代码格式修改, 注意不是 css 修改
test: 测试用例修改
chore: 其余修改, 好比构建流程, 依赖管理.
scope: commit 影响的范围（选填）, 好比: route, component, utils, build...
subject: 提交简述（必填）

body: commit 具体修改内容（选填）
能够分为多行github

footer: 一些备注（选填）
一般是 BREAKING CHANGE 或修复的 bug 的连接.测试

2. 设置模板

2.1 修改全局配置

在git全局配置里进行设置，linx/mac 进入文件.gitconfigui

$ vi ~/.gitconfig

若不存在[commit] template，则设置以下日志

[commit]
        template = /Users/zhangguoye/.stCommitMsg

2.2 修改模板

设置模板完毕后，下一步进行模板内容的修改code

$ vi  /Users/zhangguoye/.stCommitMsg

粘入如下内容保存便可。若使用sourcetree等git管理软件，则须要重启软件才能生效。component

<feat>(<>): <提交描述>

<body>

<footer>

# - type: 
    feat(新特性), 
    fix(修改问题), 
    docs(文档修改), 
    style(代码格式修改, 注意不是 css 修改), 
    refactor(代码重构), 
    test(测试), 
    chore(其余修改, 好比构建流程, 依赖管理)
# - scope: (能够为空)
    影响的的范围
# - subject
    提交描述

3. Commitizen

另外有人说用 Commitizen 替代 git commit，我就不发表意见了。但仍是建议新手少折腾。
有兴趣的能够自行了解下：
commitizen ：https://github.com/commitizen...
cz-conventional-changelog：https://github.com/commitizen...文档