如何跨平台实现子目录npm脚本调用父目录项目依赖？

针对你遇到的跨平台路径兼容性问题，这里有几个实用的方案，不用把所有脚本迁移到父目录，同时能兼容Windows、Mac和Linux系统：

方案1：使用npm exec（推荐） #

npm 5.2+ 自带的npm exec命令会自动在当前目录及上级目录的node_modules/.bin中查找可执行文件，完全不用手动处理路径问题。修改子目录的package.json脚本如下：

{
  "name": "sub-folder",
  "private": true,
  "scripts": {
    "script1": "npm exec tsc -- -p"
  }
}

为什么有效？ #

• npm exec会递归向上查找node_modules，自动定位到tsc的可执行文件
• --用来分隔npm命令和要传递给tsc的参数，确保参数能正确传递给目标工具
• 所有系统下的路径解析都由npm统一处理，完全不存在跨平台差异

你也可以用npx（npm exec的别名），写法更简洁：

"script1": "npx tsc -p"

方案2：通过Node.js直接调用模块入口 #

如果知道工具的Node.js入口文件路径，可以用node命令直接执行——Node.js的路径解析是跨平台的，不用纠结斜杠方向：

比如tsc的入口文件在../node_modules/typescript/bin/tsc，脚本可以写成：

"script1": "node ../node_modules/typescript/bin/tsc -p"

优缺点 #

• 优点：不需要依赖npm的exec命令，直接用Node.js原生处理路径
• 缺点：需要明确知道工具的具体入口路径，不同工具的入口位置可能不同，灵活性不如方案1

方案3：使用跨平台Shell工具（shx） #

如果你的项目已经安装了shx（可以在父目录的package.json中添加依赖），可以用它来处理跨平台的路径转换：

"script1": "shx ../node_modules/.bin/tsc -p"

shx会自动把Unix风格的路径转换成Windows兼容的格式，同时支持大部分常用Shell命令。不过这个方案需要额外安装依赖，不如前两个方案轻便。

额外提示 #

如果有大量类似脚本，可以考虑在子目录的package.json中定义一个通用的前缀脚本，统一维护调用方式：

"scripts": {
  "exec": "npm exec",
  "script1": "npm run exec -- tsc -p",
  "script2": "npm run exec -- eslint ."
}

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