Husky(Git 钩子工具)

Husky 是一个面向 Node.js 生态的 Git 钩子管理工具,由开发者 Typicode 创建。它让在前端和 Node 项目中配置 Git 钩子变得简单,常用来在提交或推送代码时自动触发代码检查、格式化和提交信息校验。

概述

Git 原生的钩子脚本存放在仓库的隐藏目录中,不会随代码一起被克隆,因此团队难以共享。Husky 通过将钩子目录指向项目内受版本控制的脚本,使钩子配置能够随仓库分发。安装后,开发者只需在对应的钩子脚本里写入要执行的命令,Husky 就会在相应的 Git 事件发生时运行它们。较新的版本大幅简化了配置,直接使用普通 shell 脚本作为钩子文件。

核心特点

• 配置随仓库分发:钩子脚本纳入版本控制,克隆仓库并安装依赖后即自动生效。
• 与 npm 生命周期集成:通常在依赖安装完成后自动初始化,无需成员手动启用。
• 组合能力强:常与只针对暂存文件运行检查的工具搭配,只对本次改动的文件执行格式化和静态分析,提高速度。
• 轻量:本身不提供检查逻辑,只负责触发命令,职责单一。

应用场景

Husky 是前端团队最常用的 Git 钩子方案之一。典型组合是在提交前钩子里对暂存文件运行代码检查与格式化工具,在提交信息钩子里运行 commitlint 校验提交格式,从而把代码风格统一和提交规范前移到本地提交阶段,减少后续评审负担。

常见问题

问:Husky 和 pre-commit 有什么区别?答:两者都管理 Git 钩子,但 Husky 面向 Node.js 项目、以脚本方式配置;pre-commit 是跨语言框架,以声明式配置并自动管理各钩子的运行环境。

问:钩子只对改动文件生效吗?答:Husky 本身会对整个命令生效,若想只检查暂存文件,需要搭配专门针对暂存内容运行命令的工具。

问:能强制团队成员不跳过钩子吗?答:本地钩子始终可被跳过,可靠做法是在持续集成中再执行相同检查。