VSCode不运行pre-commit钩子，真正起作用的是.git/hooks/pre-commit脚本或husky/pre-commit框架管理的钩子；“没反应”主因是Git层面环境缺失、权限不足、shell配置未加载或git.enableSmartCommit启用导致绕过暂存检查。
VSCode 本身不运行 pre-commit 钩子，它只是调用系统 Git；真正起作用的是 .git/hooks/pre-commit 脚本或 husky / pre-commit 框架管理的钩子。所谓“没反应”，90% 是 Git 层面环境缺失或权限/配置错误，不是 VSCode 设置问题。
为什么 VSCode 点提交按钮时 pre-commit 不触发
常见现象：终端里 git commit 能跑 ESLint，VSCode 点 ✔️ 却直接提交成功，连错误都没打印。
-
.git/hooks/pre-commit文件存在但没有可执行权限（chmod +x缺失） - VSCode 内置终端默认不加载
~/.zshrc或~/.bash_profile，导致pre-commit命令找不到（尤其用了pyenv或nvm） - 手动写的 shell 脚本开头没写
#!/usr/bin/env bash，在 macOS/Linux 上可能静默失败 - VSCode 启用了
git.enableSmartCommit（默认true），会把未暂存文件直接塞进 commit，绕过pre-commit对 staged 文件的检查逻辑
用 husky + lint-staged 配置可靠 pre-commit
别手写 .git/hooks/pre-commit——它易被覆盖、难维护、跨平台兼容差。husky 是当前最稳定的方案，自动注入 PATH、解析 package.json scripts，兼容 Windows 换行符和 Node 环境。
- 安装并启用：
npx husky install（会创建.husky/目录） - 添加钩子：
npx husky add .husky/pre-commit "npx lint-staged" - 在
package.json中配置lint-staged，只处理暂存区文件：
"lint-staged": {
"*.{js,ts,jsx,tsx}": ["eslint --fix", "prettier --write", "git add"],
"*.{css,scss,md}": ["prettier --write", "git add"]
}
必须加 git add：ESLint --fix 改的是工作区，不重新暂存，修复不会进本次提交。
pre-commit 钩子失败后怎么排查
VSCode 提交弹出 husky > pre-commit hook failed，说明下游命令报错，不是 husky 自身问题。
- 打开 VSCode 底部「输出」面板 → 切换到「Git」或「Tasks」标签页，看完整错误栈
- 在
.husky/pre-commit开头加echo $PATH，对比系统终端与 VSCode 内置终端的路径差异 - 检查
lint-staged执行的命令是否真的能跑通，比如单独试npx eslint --fix src/index.ts - 注意
set -e（husky v8+ 默认启用）：任何一行失败都会中断——git add权限不足、Prettier 写入失败、Node 版本不兼容都可能触发
VSCode 唯一值得动的两个设置项
它们不控制钩子执行，但影响体验和排错效率：
- 关掉
git.enableSmartCommit：设为false，否则 VSCode 会跳过暂存步骤，直接提交所有改动，lint-staged就失效了 - 慎用
git.autoRepositoryDetection：多根工作区下容易误触发，建议按需关闭
复杂点在于：钩子生效依赖的是 Git 运行时的完整环境（Python 解释器、Node 版本、PATH、虚拟环境激活状态），而 VSCode 的图形化提交流程对这些完全不感知——你得确保 .git/hooks/pre-commit 或 .husky/pre-commit 在任意 Git 调用路径下都能独立跑通。
