pre-commit钩子不能直接触发git commit，否则会导致递归；它仅校验和修复暂存区文件，失败时返回非零码中止提交，成功则由git继续完成提交流程。
pre-commit 钩子里不能直接跑测试再提交
Git 的 pre-commit 钩子只负责校验和修复暂存区文件，它没有权限、也不该触发 git commit 自身——否则会陷入递归提交。所谓“测试通过后自动提交”，本质是把“测试”作为提交门槛，失败就中断，成功才让 Git 继续走完提交流程，而不是钩子里再调一次 git commit。
-
pre-commit脚本返回非零退出码（如测试失败），Git 就会中止本次提交 - 测试命令必须针对暂存区文件（
git diff --cached --name-only过滤），否则 CI 和本地行为不一致 - 若测试含副作用（如写临时文件、改环境变量），需确保清理逻辑，否则下次钩子可能误判
lint-staged + jest / vitest 实现“仅测暂存文件”
直接在 pre-commit 里跑全量测试太慢，且容易漏掉未暂存但实际影响测试结果的文件。正确做法是用 lint-staged 按文件类型分发任务：JS/TS 文件交给 eslint --fix，同时把变更的测试文件或被修改模块的关联测试拎出来单独运行。
- 安装
jest或vitest到devDependencies，并确保有可执行的testscript - 在
lint-staged配置中加一条规则："*.{js,ts}": ["eslint --fix", "prettier --write", "npm run test:staged"] -
test:staged脚本需基于git diff --cached找出变动文件，再用jest --findRelatedTests或vitest related自动匹配对应测试文件
示例 package.json 中的脚本：
"scripts": {
"test:staged": "jest --findRelatedTests $(git diff --cached --name-only | grep '\.js$\|\.ts$' | tr '\n' ' ')"
}
VSCode 提交按钮不触发测试？检查 git.enableSmartCommit
VSCode 默认开启 git.enableSmartCommit，它会跳过 Git 原生钩子链，直接把未暂存修改打包进 commit —— 你写的 pre-commit 根本没机会执行，测试自然不会跑。
- 打开 VSCode 设置（
Cmd+,或Ctrl+,），搜索git.enableSmartCommit - 把它设为
false，强制走标准 Git 流程 - 之后必须手动
git add再点提交按钮，才能确保pre-commit被加载
验证是否生效：终端里运行 git commit -m "test" 能跑测试，但 VSCode 点 ✔️ 却秒过，那一定是这个设置没关。
测试失败时，别让修复逻辑污染暂存区
有些团队在钩子里加了 git add 自动暂存修复结果，但测试失败时如果也执行了部分 git add，会导致暂存区混入半成品文件，下一次提交可能带入错误状态。
-
git add必须放在所有检查命令之后，且仅在整条命令链成功时才执行 - 避免在测试命令后直接跟
git add；应把测试和格式化拆成独立步骤，用 shell 逻辑控制执行流 - 推荐结构：
eslint --fix && prettier --write && npm run test:staged && git add，任一环节失败整个链终止
真正卡住提交的不是按钮或插件，是 .husky/pre-commit 是否被 Git 加载、Node 环境能否找到 npx、以及 git diff --cached 输出是否为空——这三个点任意一个断掉，“自动测试+提交”就变成手动操作。
