npm 包 prefix-commit-message 使用教程

阅读时长 3 分钟读完

前言

在项目开发过程中,我们通常需要频繁地提交代码,而存在众多的提交者可能会破坏代码版本控制以及团队合作的流程,使问题难以排查与解决。本文介绍一款名为 prefix-commit-message 的 npm 包,旨在帮助开发者规范化 commit message,以避免一系列问题的出现。

prefix-commit-message 是什么?

prefix-commit-message 是一款基于 Git Commit Message 规范化的 npm 包,通过强制提交者按照一定格式书写 Commit Message,以避免不规范的提交信息给项目开发带来的麻烦。

如何安装与使用

安装:

使用: 执行命令即可开启 Commit Message 规范化:

规则说明

prefix-commit-message 规定了以下格式的 Commit Message:

其中,descriptionbodyfooter 可选。

类型(type)

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

  • feat: 新功能
  • fix: 修复 Bug
  • docs: 文档更新
  • style: 代码格式更新,如缩进、空格、分号等,不影响代码运行
  • refactor: 代码重构,既不是新增功能,也不是修复 Bug
  • test: 测试用例更新
  • chore: 其他更新,如构建流程、工程配置更新等

作用范围(scope)

scope 用于说明 commit 影响的范围,如模块、文件、文件夹等,可选项。目前已知的 scope 如以下:

  • user: 用户模块
  • blog: 博客模块
  • api: 接口模块

描述(subject)

subject 是 commit 目的的简短描述,不超过 50 个字符,以动词开头,使用一般现在时。

详细描述(description)

description 主要对 commit 进行详细的描述,可以分为多行。

正文描述(body)

body 是对 commit 的详细描述,可以分为多行。

关闭(footer)

footer 是对 commit 进行 issue 关闭操作的描述。

实战练习

以下是一个规范化的 Commit Message 实例:

总结

prefix-commit-message 可以帮助开发者规范化 Commit Message,为版本控制、协作开发提供便利,如果团队的协作开发依然被提交不规范的信息所困扰,那么这个 npm 包将是非常有意的选择,毕竟,一定要从 Commit Message 开始!

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600672693660cf7123b366ca

纠错
反馈