您的位置:

Git 代码提交规范

一、为什么需要规范化提交Git代码?

规范化提交 Git 代码的好处是显而易见的,它可以帮助开发者节省时间,提高团队合作效率,更好地管理代码版本,避免带来潜在的问题。

在一个大型项目中,参与其中的开发者可能会有很多,这就需要统一代码提交规范来简化代码管理。而规范化代码提交也能够帮助团队及时发现代码中的问题,避免冲突和出错,为整个项目开发带来秩序和规范性。

值得提醒的是,Git 代码提交规范不是一种奇术,只有你在实际开发中将其运用才能发掘其真正价值。

二、 Git 提交消息规范

在 Git 中,每一次提交都需要有一次提交消息,这个提交消息就是一段文字说明。规范的提交消息不仅使得 Git 历史记录易于阅读,而且在查询和研究项目代码的历史记录时非常有用。

下面是提交消息的标准格式:

    类型: 主题

    主体内容

    应用范围

其中,提交消息主要包括以下3个部分:

1、类型:对提交的修改进行分类,主要包括以下类型:

  • feature:新功能
  • fix:修复问题
  • docs:只修改了文档
  • style:代码风格美化、格式修正等无关功能代码变更
  • refactor:代码重构
  • test:测试相关
  • chore:其他不影响代码功能的更改,比如构建工具、依赖库等的更新或者二次封装

2、主题:是一个简短的、准确的描述,通常不超过50个字符。主题应该简洁地概括修改做了什么,而不是说明修改为什么而做什么。

3、主体内容:是一个更长的、更详细的、对提交所做的修改进行详细解释的内容。主体内容可以是多行,通常不超过72个字符,中间以空行隔开。

三、 Git 分支命名规范

Git 分支是开发者在 Git 仓库中角色的一种,可以方便地管理代码的版本。当需要开发新功能或者修复已知的 Bug 时,我们通常需要新建一个分支,此时需要遵循分支命名规范,以便更好地管理代码。

分支名通常由以下几部分组成:

    <类型>/<名称>/<数字 ID> 

其中,类型指的是该分支所属的类型,建议使用以下几种类型:

  • feature:功能开发分支;
  • bugfix:问题修复分支;
  • hotfix:紧急问题修复分支;
  • release:发布版本分支,每次发布一个新的版本都需要新建一个 release 分支;
  • docs:文档更新分支;

名称是指分支的名称,使用 - 来作为单词的分隔符。

数字 ID 是指相关需求、缺陷、任务的 ID,这样可以方便地对问题进行追踪。

四、 Git Commitizen 工具的使用

Commitizen 是一款优秀的 Git 提交信息规范工具,支持 Commit message 格式化,可视化地选择修改类型、影响的范围、文件名等。

使用 Commitizen 可以大大提升代码提交的规范化和效率化,我们只需要根据一个简单的命令格式输入相关信息即可生成规范的提交信息。

    npm install -g commitizen
    commitizen init cz-conventional-changelog --save-dev --save-exact
    git cz

在执行 git cz 命令之后,会启动 Commitizen 客户端,并通过一步步提问的形式来生成规范的提交消息。

五、规范化 Git 提交动作

规范化 Git 提交过程中,我们不仅需要关注提交的消息格式、分支命名规范等,还需要关注实际提交前的一系列操作。下面我们来谈一谈规范化提交动作的相关内容。

要规范化提交动作,我们需要明确的了解提交的流程,以及相关的规范化操作,如下:

  • Git reset 和 Git revert 的使用;
  • Git squash 的使用;
  • 代码合并的规范化流程。

六、 总结

Git 代码提交规范对于项目的管理和团队的协作效率非常有帮助,本文通过实际经验介绍了 Git 提交消息规范、Git 分支命名规范、Commitizen 工具的使用以及规范化 Git 提交动作等内容。