提交前跑四十秒,两周后全组都在用 --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。
查看「工程效能」全部文章 →

同分类文章

查看 0 评论 0

评论

正在加载评论…

留言提交后自动审核:正常内容立即显示,含敏感信息的会转人工复核。

提交前跑四十秒,两周后全组都在用 --no-verify - 起航社区