Husky提交失败报错：.husky/pre-commit第4行npx命令未找到

报错原因 #

重启设备后，Git执行钩子时使用的默认PATH不包含Node.js/npm/npx的安装路径，导致找不到husky和npx命令。

修复步骤 #

• 先在终端执行以下命令，获取node和npx的实际路径：

  which node
  which npx
  

  输出类似/usr/local/bin/node或~/.nvm/versions/node/v18.17.0/bin/node，记下对应的bin目录（比如/usr/local/bin或~/.nvm/versions/node/v18.17.0/bin）。

• 编辑项目根目录下的.husky/pre-commit文件，在文件最顶部添加一行，将上述bin目录加入PATH：

  export PATH="/你的node所在bin目录:$PATH"
  

  示例（如果是nvm管理的node）：

  export PATH="$HOME/.nvm/versions/node/v18.17.0/bin:$PATH"
  

  或者如果用的是zsh/bash，也可以直接加载你的shell配置文件（确保里面配置了node环境）：

  source ~/.zshrc
  # 或者 source ~/.bashrc
  

• 验证修复：执行空提交测试

  git commit --allow-empty -m "test husky fix"
  

  如果没有报错，说明修复成功。

长期解决方案 #

确保你的shell配置文件（如~/.zshrc、~/.bashrc）中正确配置了Node.js/nvm的环境变量，并且可以考虑在.husky/_/husky.sh文件开头添加加载shell配置的命令，让所有husky钩子都能继承正确的环境变量。

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