提交前跑四十秒,两周后全组都在用 --no-verify
pre-commit 里塞了全量 lint 加类型检查,每次提交等四十秒,最后大家都学会了加 --no-verify。钩子不是被优化好的,是被绕过去的。这篇讲检查分层、lint-staged 的增量范围,以及钩子自身的启动开销。
提交前跑全量 lint 加类型检查,四十秒起步,两周后团队里一半人开始加 --no-verify。钩子不是被改好的,是被绕过去的——而绕过去之后,它连存在意义都没有了。
先把检查分层
提交前只做「本次改动」的检查,秒级返回;推送前跑类型检查与单测;CI 跑全量,作为唯一准入门槛。
这条分层的道理很简单:本地钩子的作用是缩短反馈,不是保证质量。任何「只有靠钩子才能拦住」的规则,最后都会因为太慢而被关掉。
lint-staged 的正确用法
{
"lint-staged": {
"*.{ts,tsx,vue}": ["eslint --fix --max-warnings=0"],
"*.{css,scss}": ["stylelint --fix"],
"*.{json,md}": ["prettier --write"]
}
}
它只把暂存的文件传给命令,这是快的前提。但要注意:命令拿到的是整个文件,而 git 里可能只暂存了部分修改。也就是说,检查的是工作区内容,提交的是暂存内容,两者不一致时会出现「本地检查过了,CI 不过」。
真正的解法是养成「提交前先暂存全部意图」的习惯,或者在 CI 里跑同样的规则兜住。
钩子本身的启动开销
husky 每次触发都要起一个 node 进程,几百毫秒不见了;在钩子里写 npx xxx 会再解析一遍依赖树;monorepo 里 node_modules 层级深,路径解析更慢。
改成直接调用本地二进制,或者换用编译型实现(如 lefthook、pre-commit 的 rust 版本)能砍掉这部分固定成本:
# .husky/pre-commit
pnpm exec lint-staged --concurrent 2
--concurrent 要按机器核数设,默认并发过高时 ESLint 反而更慢。
别放进提交前的东西
- tsc --noEmit:全项目类型检查,几十秒起步,放 pre-push 或 CI;
- 完整测试套件:同理,本地跑单文件相关测试就够;
- 构建产物校验:让 CI 做,本地做了也不代表线上能过。
# .husky/pre-push —— 只做一次性的重检查
pnpm exec tsc --noEmit && pnpm exec vitest run --changed
适用边界与常见坑
- --no-verify 一定存在,所以 CI 必须重复同样的检查,钩子只是加速器不是守门员。
- Windows 上 CRLF 和缺失 shebang 会让钩子静默不执行,报错也没有,先手动跑一次确认。
- 钩子失败时输出常被截断,看不到具体文件,临时加 --debug 排查。
- 新同事 clone 后没装钩子,用 prepare 脚本挂上,并在 README 写一行说明。
- 只改了暂存区一部分时,lint-staged 的自动修复可能把未暂存的改动也格式化掉,提交前看一眼 diff。
正在加载评论…