IDE中Husky与Git Hooks校验规则失效问题求助

核心原因 #

IDE集成的Git通常使用独立运行环境（比如自带Git版本、环境变量PATH与终端不一致），导致husky钩子无法正常执行；也可能是钩子脚本权限不足，或是IDE默认跳过了Git钩子校验。

具体解决步骤 #

1. 修复钩子脚本执行权限 #

IDE可能因钩子脚本无执行权限而跳过执行，执行以下命令为所有钩子添加权限：

chmod +x .husky/* .husky/_/*.sh

2. 让IDE使用系统全局Git #

很多IDE默认自带Git，但其环境变量和终端不一致，会导致npx等命令无法被找到：

• VSCode：打开设置，搜索Git: Path，将路径设置为系统全局Git的安装路径（比如/usr/bin/git或C:\Program Files\Git\bin\git.exe）
• 修改后重启IDE生效

3. 同步IDE与终端的环境变量 #

IDE的PATH变量可能不包含npm/npx的路径，导致钩子中的命令无法执行：

• 可以直接从终端启动IDE来继承终端的环境变量，比如VSCode执行：

  code .
  

  这样启动的IDE会复用终端的PATH配置，确保npx能正常调用。

4. 重新初始化husky钩子 #

钩子关联可能失效，重新安装并生成钩子：

npm uninstall husky
npm install husky --save-dev
npx husky install
npx husky add .husky/pre-commit "npx lint-staged"
npx husky add .husky/commit-msg "npx commitlint --edit $1"
npx husky add .husky/pre-push ".husky/pre-push"

5. 检查IDE是否默认跳过钩子 #

部分IDE或第三方Git插件会默认添加--no-verify参数跳过钩子：

• VSCode：检查是否安装了第三方Git插件，查看插件设置是否有跳过钩子的选项；同时确认设置中Git: Disable Hooks未被勾选。

6. 验证钩子是否被触发 #

可以在钩子脚本中加日志输出，比如在pre-commit开头添加：

echo "Pre-commit hook triggered" >> .husky/hook-log.txt

用IDE提交代码后，查看是否生成日志文件，判断钩子是否被执行。

额外注意项 #

• husky v6+不再读取package.json中的husky字段配置，建议删除该字段，完全使用.husky文件夹下的脚本，避免配置冲突。
• 自定义pre-push脚本中的正则表达式要确保语法正确，比如允许feature/bugfix分支的规则应该写成^(feature|bugfix)/.+$，避免因正则错误导致脚本异常。

内容的提问来源于stack exchange，提问作者Lushmoney