Git提交失败：husky预提交钩子报错npx命令未找到的问题求助

我之前也碰到过一模一样的情况，明明本地终端能正常跑npx --version，但husky hook就是找不到npx，给你几个亲测有效的解决思路：

思路一：彻底重置Husky配置 #

有时候删了.husky目录，但Git的hooks路径配置还残留着，导致它还是试图去加载不存在的旧hook脚本：

• 先清除Git的hooks路径配置：

  git config --unset core.hooksPath
  

• 确保.husky目录完全删除（如果之前删了但还有残留再跑一次）：

  rm -rf .husky
  

• 重新初始化Husky并重建hook：

  npx husky install
  # 如果你之前用的是lint-staged这类工具，重新添加pre-commit hook
  npx husky add .husky/pre-commit "npx lint-staged"
  

思路二：修复Git的环境变量PATH #

核心问题是Git hook运行的环境和你当前终端的环境不一样——Git默认可能用的是系统shell（比如macOS的bash），而你的终端用的是zsh/fish，Node/npx的路径只在你常用的shell配置里（比如.zshrc）被添加到PATH，Git没加载这个配置：

• 先验证这个问题：临时修改.husky/pre-commit脚本，在第3行添加echo $PATH，然后运行git commit，看看输出的PATH里有没有Node的bin目录（比如~/.nvm/versions/node/xxx/bin）
• 如果确实没有，有两种解决办法：
  1. 把Node的路径添加到Git的环境变量里：运行git config --global core.path "$PATH"（把你终端里的PATH直接传给Git）
  2. 让Git用你当前的终端shell：比如你用zsh的话，运行git config --global core.shell /bin/zsh

思路三：直接用npx的绝对路径 #

如果上面的方法都嫌麻烦，直接在hook脚本里替换成npx的绝对路径：

• 先找到npx的绝对路径：

  which npx
  

  会输出类似/Users/your-name/.nvm/versions/node/v18.17.0/bin/npx的路径
• 打开.husky/pre-commit脚本，把所有的npx替换成这个绝对路径

补充说明 #

报错里的code 127就是系统找不到指定命令的意思，本质就是Git hook的运行环境里找不到npx的可执行文件，所以核心就是让Git能访问到npx的路径。

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