TOOL PICKS / 2026.11.21
小团队要把格式检查、测试或生成类检查写成仓库里的 Git hooks 时,真正要问的不是「哪家更流行」,而是:仓库是不是本来就走 Node 包管理、钩子配置怎么进 Git、同事 clone 之后会不会漏装,以及 CI 里到底该安装钩子,还是直接跑同一套检查。
结论:仓库已经是 Node / npm 工作流、希望钩子就是 .husky/ 里的脚本,优先 Husky;要以一份 YAML 集中管理、支持多种语言安装方式,并在钩子里断言二进制还在,优先 Lefthook;已经用 Python 工具链、要用社区 hook 仓库,并在 CI 里跑 pre-commit run --all-files,优先 pre-commit。不要把「clone 之后自动装好」当成三家共同的默认能力。
以下为 2026 年 11 月 21 日的文档核验对比,不是本机在三套工具里安装或跑 hook 的实测;命令、默认行为与环境变量以各官网当日页面为准,可能会变。
把任务钉死:同一份仓库里的检查,能写成可共享的 Git hooks,同事 clone 后知道怎么落到本机,并且 CI 不会在漏装时假装已经跑过钩子。
先钉任务,再谈钩子管理器
本文只服务一个固定任务:把仓库级的 Git hooks 写成团队可共享的配置,减少「只有某台电脑上跑得过」的口口相传。包含:配置以什么形式进版本库、clone 后如何安装到 .git/hooks、CI 里是安装钩子还是直接跑检查,以及钩子脚本还在、可执行文件已经不在时,会不会静默跳过规则。
这和 11 月 7 日那篇「用 Bruno、Insomnia、Postman 跑 HTTP 集合回归」、11 月 11 日的本机容器桌面、11 月 14 日的本地 API 替身不是同一件事。那些文章选的是客户端、容器或 mock 服务器;这里选的是 hook 管理器。若只是要在 CI 里跑一次 linter,不必先引入 hooks 框架。
淘汰条件也先写清:文档里找不到「配置如何进仓库」的说明,淘汰;完全依赖每人手写本机 hook、不能复述官方安装入口,淘汰;把某家的自动安装写成三家都有,却对不上当日文档,淘汰。
三家官方口径分别承诺了什么
Lefthook 文档把发行形态写成独立、无额外依赖的二进制,并列出多种语言包管理器和系统包安装方式。关键的漏装防护写在配置项 assert_lefthook_installed:默认是 false;设为 true 时,如果在 $PATH、node_modules/、Ruby gem 或其他受支持位置找不到可执行文件,就以退出码 1 失败,避免 Git hook 在 Lefthook 曾经装过、后来却找不到时省略规则。
同一站点的 CLI 页还提供 lefthook check-install:检查 Git hooks 是否已安装且与配置同步;已安装并同步则返回 0,未安装或需要同步则返回 1。安装命令 lefthook install 会在没有配置文件时创建空的 lefthook.yml,并把已配置的 hooks 装进 Git hooks。
文档注明:改 lefthook.yml 不必重新安装,因为每次跑 hook 都会读配置;使用 npm 包装的 lefthook 时,postinstall 会自动执行安装,非 npm 项目则需在 clone 之后手动跑 lefthook install。CI 环境变量页则写:使用 npm 包装时,若要避免 postinstall 在 CI 里装 hooks,应设置 CI=true(若 CI 没有自动设置);也可用 LEFTHOOK=1 或 LEFTHOOK=true 覆盖这一行为。

pre-commit 官网把日常使用拆成:先安装 pre-commit,再添加 .pre-commit-config.yaml,然后执行 pre-commit install 安装 Git hook 脚本。CI 一节明确写:也可以把 pre-commit 当作持续集成工具,例如在 CI 步骤里加入 pre-commit run --all-files;若只检查有改动的文件,可用 pre-commit run --from-ref origin/HEAD --to-ref HEAD。文档还说明默认仓库缓存在 ~/.cache/pre-commit,可用 PRE_COMMIT_HOME 或 XDG_CACHE_HOME 改位置,并给出多套 CI 缓存示例。这与「把 hook 装进 CI runner 再靠提交触发」不是同一条路:官方把 CI 写成直接跑检查。

Husky 文档把新钩子写成在 .husky/ 下创建文件,例如 echo "npm test" > .husky/pre-commit。Get started 页推荐 husky init。How To 页用专门一节写 CI 与 Docker:为避免在 CI 或 Docker 里安装 Git hooks,使用 HUSKY=0,并给出 GitHub Actions 的 env: HUSKY: 0 示例。若安装时只装 dependencies、不装 devDependencies,prepare: "husky" 可能失败;文档给出把脚本改成 husky || true 等处理办法。可见 Husky 的默认叙事绑定在 Node 项目的 package.json 生命周期上,和 Lefthook、pre-commit 的跨语言安装入口并不相同。

用同一把尺子看五维决策表
下表只整理 2026 年 11 月 21 日能在官方文档里对上的条目,不是实测评分,也不对「谁更快、谁界面更好看」打星。
| 维度 | Lefthook | pre-commit | Husky |
|---|---|---|---|
| 主配置怎么进仓库 | 文档以 lefthook.yml 为配置文件;改配置不必重新执行 install | .pre-commit-config.yaml,再 pre-commit install 安装 hook 脚本 | 钩子就是 .husky/ 目录里的文件;文档示例直接创建 .husky/pre-commit |
| 安装与语言生态 | 独立二进制,文档列出多种语言与系统包管理器 | 先安装 pre-commit 工具,再写 YAML、装 hook;生态以 hook 仓库和 Python 工具链为常见路径 | 文档入口围绕 npm 工作流、husky init 和 package.json 的 prepare 脚本 |
| clone 之后如何落到 Git hooks | npm 包装会在 postinstall 自动执行 lefthook install;非 npm 项目需在 clone 后手动安装 | 需要执行 pre-commit install 才能把 hook 脚本装进仓库 | 常见路径是依赖 prepare 在安装依赖时触发;文档同时说明 CI 或只装生产依赖时可能要改脚本或关闭安装 |
| CI 里装钩子还是直接跑检查 | 文档写明用 CI=true 可阻止 npm 包装在 postinstall 装 hooks,也可用 LEFTHOOK=1 覆盖 | 官方把 CI 写成 pre-commit run --all-files(或按引用范围跑),并讨论缓存 | 官方写明在 CI / Docker 使用 HUSKY=0,避免在这些环境安装 hooks |
| 漏装时能否失败 | 可开 assert_lefthook_installed,找不到可执行文件则退出 1;另有 lefthook check-install 用 0/1 表示是否已安装并同步 | CI 路径是直接跑检查,漏装 hook 不等于漏跑检查;本机若没执行 pre-commit install,文档并不把提交时的 hook 写成已经存在 | 文档重点是如何跳过或避免安装,而不是提供与 Lefthook 同类的「断言可执行文件仍在」开关 |
怎么落地,以及何时不要换
- 本周:先填两格——仓库是不是本来就用 npm 管理前端或全栈依赖;团队更希望「提交时在本机拦」,还是「CI 里跑同一份检查」。两格都空时,不要先为「统一工具」争论。
- 试点:只选一个没有密钥的检查(例如格式化或清单校验),按官方入口把配置写进仓库,再找第二台干净环境按文档完成安装或确认 CI 命令。不要一上来比较谁的社区 hook 更多。
- 进 CI:pre-commit 按文档把
pre-commit run --all-files写成步骤;Husky 按文档在 CI 设HUSKY=0,把真正要跑的检查写成独立任务;Lefthook 若用 npm 包装,先核对 CI 是否已设置CI=true,再用lefthook check-install或assert_lefthook_installed决定要不要在流水线里检查安装状态。 - 不要换的情况:仓库已经是 Node 项目、钩子也已经是
.husky/文件——不必为了「YAML 看起来更整齐」整仓迁移;检查已经只在 CI 跑、本机并不依赖提交钩子——直接保留 CI 命令,不必再绕去引入 hook 管理器。 - 先停再看文档:团队没有人维护第二语言的运行时,却要强行上另一套生态的默认安装路径时,先对照官方安装页,而不是口播「都差不多」。
我们的判断:仓库级 hooks 的胜负手是「clone 后怎么落到本机」和「CI 里漏装会不会被当成已经检查过」,不是皮肤。文档核验下:Node 仓库且钩子就是文件,优先 Husky;要 YAML、多语言安装和漏装失败,优先 Lefthook;要以配置文件加 pre-commit run --all-files 进 CI,优先 pre-commit。无本机实测前,先用上表开例会,再决定要不要做一周试点。
参考链接
- Lefthook Docs:Install Lefthook
- Lefthook Docs:assert_lefthook_installed
- Lefthook Docs:lefthook install
- Lefthook Docs:lefthook check-install
- Lefthook Docs:环境变量 CI
- Lefthook 文档首页
- pre-commit 官网(含安装 hook 脚本与 Usage in continuous integration)
- Husky Docs:Get started
- Husky Docs:How To(含 CI server and Docker)
- GitHub:evilmartians/lefthook
- GitHub:pre-commit/pre-commit
- GitHub:typicode/husky


Список комментариев (0 записей):
Показать ещё отзывы Загрузка...