自觉是不可靠的#

规范配好了，但有人忘了跑 lint 就提交，CI 才报错，来回返工。把检查移到”提交动作那一刻”——提交前自动跑，过不了就不让提交。

Husky：钩子管家#

Husky 让你方便地往 Git 生命周期挂脚本：

1
npx husky init
2
# 在 .husky/pre-commit 写入：
3
npx lint-staged

pre-commit 在 git commit 执行前触发。如果脚本退出码非 0，提交被中止。

lint-staged：只查改动的文件#

全量 lint 在大项目很慢。lint-staged 只对你本次暂存（staged）的文件跑检查，速度快、且只格式化你改的：

1
{
2
  "*.{ts,tsx,js}": ["eslint --fix", "prettier --write"],
3
  "*.css": ["stylelint --fix", "prettier --write"]
4
}

--fix 顺便自动修格式问题（如补分号、改引号），提交进来的代码永远是干净的。

完整防线#

1
开发者写代码
2
  → git commit（Husky pre-commit 触发 lint-staged：格式化+检查）
3
      ├─ 有问题 → 自动 fix 或报错，提交中止，开发者改完重提
4
      └─ 通过 → 提交成功
5
  → push → CI 再跑一遍（lint + typecheck + test + build）

本地钩子是第一道，CI 是兜底（有人绕过钩子也能卡住）。

小结#

• 靠自觉跑 lint 必漏，检查要绑到 pre-commit。
• Husky 挂钩子，lint-staged 只查暂存文件、快且精准。
• --fix 自动格式化，进仓库即干净。
• 本地钩子 + CI 双重防线，质量不靠人。

练习#

1. 给项目加 Husky + lint-staged，提交一个格式乱的文件，观察被自动 fix。
2. 故意提交一个 ESLint 报 error 的代码，确认提交被中止。
3. 解释为什么 CI 还要再跑一遍 lint（钩子可被 --no-verify 跳过）。