NPM如何调用未在PATH中的ava命令？求原理及源码说明

你猜的完全正确！npm在执行脚本时确实会优先从项目本地的node_modules/.bin目录查找命令，这背后是npm对脚本执行环境的特殊处理。

核心原理 #

当你直接在终端输入ava时，系统会遍历系统PATH环境变量里的目录来找这个可执行文件，但你的本地项目node_modules/.bin不在系统PATH里，所以找不到。

而npm运行scripts里的命令时，会做以下操作：

• 临时修改当前命令的PATH环境变量，把项目根目录下的node_modules/.bin加到PATH的最前面
• 在这个修改后的环境里执行脚本命令

node_modules/.bin目录里存放的是你通过npm安装的依赖包提供的可执行文件的软链接——比如你安装ava后，npm会自动在这里创建一个指向node_modules/ava/cli.js的ava链接，这样npm脚本就能直接调用它了。

验证这个逻辑 #

你可以在package.json里加一个测试脚本：

{
  "scripts": {
    "test": "ava tests/*.js --verbose",
    "check-path": "echo $PATH" // Linux/macOS
    // "check-path": "echo %PATH%" // Windows
  }
}

运行npm run check-path，你会看到输出的PATH最开头就是./node_modules/.bin，这就证明了npm确实临时修改了环境变量。

源码相关参考 #

如果你想深入看npm的实现逻辑，可以查看npm源码里的lib/run-script.js模块，其中的makeEnv函数负责构造脚本执行的环境变量，核心就是把本地node_modules/.bin目录添加到PATH的头部。另外，lib/utils/lifecycle.js里也有处理脚本执行路径的相关逻辑。

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