[译] 使用 Husky 和 Hooks 保证 JavaScript 代码质量

对于一个可维护和可扩展的应用程序来讲,保证代码质量无疑至关重要。但我们如何在项目中执行与质量相关的标准呢?

在 JavaScript 中,你可以使用 ESLint 来定义编码规范,同时可以使用 Prettier 来实现统一的代码风格配置。如果你已经配置了这两个工具,那就已经完成了保证代码质量的第一步。

现在我们已经有了相关的质量标准,如何执行它们?这时候就需要 Husky 了。在基于 Git 项目中,Husky 常常用于保证关于质量标准的执行。它的作用类似于 Bit独立组件 发布新版本之前会强制执行代码规范,然后再导出到各个远程分支(稍后会有详细的介绍)。

什么是 Hooks

当你使用 Git (git init ) 初始化一个项目时,它会自动提供一个名为 Hooks(钩子)的功能。你可以在 [项目根目录]/.git/hooks 下查看它。

你会看到有许多 Git Hooks。部分如下:

  • pre-commit —— 用于保证代码提交前执行所有编码规范的钩子。它将在你执行 git commit 命令时运行。
  • pre-push —— 用于保证代码在推送到远程仓库之前符合编码规范。
  • pre-rebase —— 类似于上面的作用,它是在 rebase 操作完成之前执行的。

所有可用的 Hooks 和它们的用法都可以在这里找到。

然而,手动编写这些 Hooks 并保证所有开发人员都在他们的设备上遵循这些规则是一个极为繁琐的过程。这时候就需要 Husky 了。

什么是 Husky

Husky 让 Hooks 的添加过程自动化了。当项目中的依赖安装完成后,Husky 会根据项目中 package.json 配置,确保所有 Hook 都将安装在开发人员的设备中。这使得管理和分发 Hooks 简单了很多,不需要在手动编写了。

使用 Husky,会开启如下的流程:

  • 本地创建 Hooks 钩子。
  • 调用相关的 Git 命令时会自动执行对应的钩子。
  • 对参与项目代码贡献的人来说,项目中定义的编码规范是强制执行的。

项目中开始使用 Husky

你可以使用如下的命令安装 Husky。

npm install husky --save-dev

配置 Husky 非常简单。可以在 package.json 中如下配置。

"husky": {
  "hooks": {
    "pre-commit""",  // pre-commit 命令添加到这里
    "pre-push""",    // pre-push 命令添加到这里
    "...""..."
  }
}

像这样,你可以在这里配置任何你所需的钩子。

让我们看一个例子。

如果你想确保在提交更改前你的代码满足所有的 lint 规则校验,可以进入如下操作。

{
  "scripts": {
    "lint""eslint . --ext .js",
  },
  "husky": {
    "hooks": {
      "pre-commit""npm run lint"
     }
  }
}

这个配置应该添加到 package.json 中。它会保证代码在没有通过 esLint 校验到情况下无法完成 Git 提交。

Husky 在实践中的更多应用

到目前为止,我们已经了解了 Husky 最基本的使用方法。我们可以用这个包做更多的事情吗?让我们看一下。

  1. Husky 能够运行任何命令,它可以和其他包组合进行工作(例如:与 Prettier 组合进行格式化、与 EsLint 组合为准备提交的代码文件执行静态分析等)。
  2. Husky 能够验证提交信息时使用等 commit-msg,类似于 pre-commit 校验规则。
  3. 我们可以使用 pre-commit 命令运行所有单元测试和集成测试,这就确保不会提交任何破坏性修改。

然而,需要注意的是,如果你在 Git 命令中使用了 no-verify 标志,就可以跳过 Husky 命令了。

支持的 Hooks

Husky 支持这里定义的所有的 Git Hooks。服务端 Hooks(pre-receiveupdatepost-receive)这些不支持。

Husky 的特点

这里我想提一下 Husky 的几个突出特点。

  • 零依赖和轻量化(6KB)
  • 由当下 Git 的新特性 (core.hooksPath) 驱动
  • 遵循 npmYarn 自动安装的最佳实践
  • 友好的用户消息提示
  • 选择性安装
  • Husky 4 支持 macOS、Linux 和 Windows 平台
  • 进一步,它支持 Git GUI、自定义目录和 Monorepos

总结

使用 Husky 和 Git Hooks 可以实现格式化、符合 lint 校验规则的无误的代码构建。这让执行编码规范变得非常简单和快速。

或者,你可以考虑使用 Bit 之类的工具来提高代码质量。

从我开始在我的项目(小规模或企业级项目)中使用 Husky 的那天起,编码生活变得更简单了。