美文网首页
git提交规范说明

git提交规范说明

作者: 晨钟暮鼓_7bc3 | 来源:发表于2022-02-28 15:37 被阅读0次

h3. 清晰的代码提交规范,有利于我们代码方便的查找和维护。可以约定提交格式如下:

--------------------- 格式start -----------------------

<type>[scope]: <subject>
空一行
[可选的正文 body]
空一行
[可选的页脚 footer]

---------------------- 格式end-----------------------

  • type:
    提交类型,必填项,详细可以分为:

feat: 新功能feature
fix:修复bug
docs: 文档注释
style:代码格式,不影响代码运行的变动
refactor:重构、优化(既不增加新功能也不修复bug)
perf:性能优化
test:增加测试
chore:构建过程或者辅助工具的变动
revert:回退
build:打包
ci:与ci 持续集成有关的改动
temp:临时代码,不计入 CHANGELOG,比如必须部署到某种环境才能测试的变更。如测试真机上 transparent title 启动参数是否设置成功

  • scope:

scope也是必填项,用于描述改动范围,格式一般为 项目名/模块名 例如:
node-pc/common
如果一次commit修改多个模块,建议拆分为多次commit,以便更好的追踪和维护。

  • subject:

填写简单的提交说明,言简意赅,不超过50字,可以清晰明了的指出修改的意图。

  • body:

选填,用于填写更详细的描述。主要描述改动之前的情况和修改动机,对于小的修改可以没有,但是重大需求、更新等必须添加body来作说明。

  • footer:

选填,用填写关联的issus,或者BREAK CHANGE.
必须是大写,表示引入了破坏性 API 变更,通常是一个大版本的改动,BREAKING CHANGE: 之后必须提供描述,下面一个包含破坏性变更的提交示例:

feat: allow provided config object to extend other configs

BREAKING CHANGE:extendskey in config file is now used for extending other config files

当然,一方面规范需要大家都自觉遵守,但是使用现有的工具来约束规范可以达到事半功倍的效果。所以针对不同的开发环境可以选择合适自己的代码提交规范格式化工具,利用git hooks来约束提交规范。 __

相关文章

  • git commit 提交规范(优化)

    git commit 提交模板和规范 Git每次提交代码,都要写 Commit message(提交说明),否则就...

  • git提交规范说明

    h3. 清晰的代码提交规范,有利于我们代码方便的查找和维护。可以约定提交格式如下: ---------------...

  • git commit规范

    git commit规范 git-commit规范 在多人协作项目中,如果代码风格统一、代码提交信息的说明准确,那...

  • 用 git 钩子,检测代码规范性(eslint、standard

    最终实现效果说明: 用 git commit 提交代码之前,利用 pre-commit git 钩子,实现代码规范...

  • git commit 提交规范

    不规范? Git每次提交代码,都要写 Commit message(提交说明),否则就不允许提交。但是,一般来说,...

  • iOS 小谈一叙

    一、规范 1) git 提交规范 适当使用git merge / git rebase 2) 代码规范 注意改动别...

  • 我的git学习日志

    关于提交规范(git commit conventions) 参考文献: 你可能会忽略的 Git 提交规范Comm...

  • Git的分支命名

    主要规范两点: git 分支命名规范 git提交记录规范 一. git 分支命名规范 git分支分为集成分支、功能...

  • git commit提交规范

    git commit提交规范代码提交信息的说明,能够使项目在后期协作以及Bug处理时更加容易理解 【1】commi...

  • 《git权威指南笔记》

    修改提交说明 git commit --amend修改最新提交的提交说明 git rebase -i

网友评论

      本文标题:git提交规范说明

      本文链接:https://www.haomeiwen.com/subject/ncmlrrtx.html