如何让VS Code源代码管理提交时触发husky pre-commit的eslint校验

核心原因说明 #

终端提交正常但IDE内置Git提交不触发钩子，90%以上的情况是IDE调用Git时读取的PATH环境变量和终端不一致，找不到node、npx等执行路径，导致husky钩子静默失败。你可以按照以下步骤逐一调整：

调整步骤 #

1. 补全钩子可执行权限
   终端进入项目根目录执行命令，确保pre-commit钩子有执行权限：
   chmod +x .husky/pre-commit
   如果是husky 8+版本，确保你已经执行过husky install初始化，最好在package.json的scripts中添加"prepare": "husky install"，保证每次装完依赖自动初始化husky。

2. 修正pre-commit脚本的环境变量声明
   在你的.husky/pre-commit文件最顶部添加环境变量声明，优先加载本地node执行路径，适配nvm等node版本管理工具的场景：

# 适配nvm环境，优先读取终端node路径
export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"
# 未使用nvm的用户可以直接替换为本地node的bin目录绝对路径，比如/usr/local/bin

标准的pre-commit完整参考写法如下：

#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"

npx lint-staged

3. 确认IDE的Git钩子配置开启

• VSCode打开设置，搜索git.enableCommitHooks，确认该选项为勾选状态（默认开启，避免之前被手动关闭）
• Mac用户可以直接从终端执行code .启动VSCode打开项目，此时VSCode会继承终端的全部环境变量，提交行为和终端完全一致。

4. 兜底排查方法
   如果以上调整都无效，可以在pre-commit脚本开头加日志输出，定位具体错误原因：

# 日志会输出到项目根目录的commit.log文件
exec > ./commit.log 2>&1
echo "当前PATH变量：$PATH"
echo "node版本：$(node -v)"
echo "npm版本：$(npm -v)"

提交一次后查看commit.log内容即可定位问题。

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