使用Npm的bin功能时，如何向Node二进制文件传递flags参数？

我正在开发一个小型npm包，其package.json的bin字段指向编译后的脚本：

{
  "name": "myBin",
  "bin": ".dist/cli.js",
  "main": ".dist/cli.js"
}

现在需要用Node的--loader（或--experimental-loader）参数运行该脚本，以支持加载TypeScript插件。但无法直接把参数放到scripts字段里，因为这些Node参数必须出现在脚本名称之前（npm会处理bin命令的路径映射）：

{
  "name": "myProject",
  "scripts": {
    "dev-npm": "myBin ...",
    "dev-node": "node --loader esbuild-register/loader node_modules/myBin ..."
  },
  "dependencies": {
    "myBin": "*"
  }
}

注：之前误以为Node可以在脚本名称后接收这类参数，实际不行。

有没有办法通过npm调用该bin脚本时，自动加入所需的Node参数？我考虑过让myBin内部以子进程形式调用node --loader ... myBin，但这种包装方案不够理想。

这里提供几种更合理的实现方式：

1. 利用NODE_OPTIONS环境变量 #

Node会读取NODE_OPTIONS环境变量中的参数，你可以在运行脚本时直接设置：

# 临时单次运行
NODE_OPTIONS="--loader esbuild-register/loader" npm run dev-npm

也可以把环境变量直接写在package.json的scripts里（跨平台建议搭配cross-env包）：

{
  "scripts": {
    "dev-npm": "cross-env NODE_OPTIONS='--loader esbuild-register/loader' myBin ..."
  },
  "devDependencies": {
    "cross-env": "^7.0.3"
  }
}

这种方式灵活，不会强制所有用户使用该loader，用户可以根据需要开启。

2. 修改bin脚本的Shebang #

如果希望所有使用该包的用户默认带上loader参数，可以修改.dist/cli.js的开头shebang：
把原来的

#!/usr/bin/env node

改成

#!/usr/bin/env node --loader esbuild-register/loader

不过要注意，这种方式会绑定loader参数，用户无法轻易修改，适合包本身强依赖该loader的场景。

3. 使用npm exec传递Node参数 #

npm exec支持通过--node-options直接指定Node运行参数，调用方式如下：

npm exec --node-options="--loader esbuild-register/loader" myBin ...

这种方式不需要修改包或项目配置，适合临时调试或特殊场景下的调用。

4. 在myBin包中提供专用启动脚本 #

在myBin的package.json中添加一个启动脚本：

{
  "scripts": {
    "start": "node --loader esbuild-register/loader .dist/cli.js"
  }
}

用户可以通过以下命令调用：

npm exec myBin start ...

这种方式把loader逻辑封装在包内部，用户不需要关心参数细节，但调用方式和直接用bin命令有区别。

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