能否向npm命令字符串（而非其执行的脚本）传递自定义参数？

核心运行规则 #

npm 在执行scripts字段内的命令时，自身会优先解析命令行中带连字符的配置项。要把自定义参数透传给脚本内部，必须先用固定的--做分隔标记，标记之后的所有参数都会原样传入脚本的执行上下文。

常见误区：如果省略--分隔符直接写npm run build:docker --tag '1.0'，npm会把--tag当成自身CLI的配置参数吞掉，根本不会传递给后续的shell命令，这也是很多人传参不生效的核心原因。

两种适配你需求的实现方案 #

方案1：位置变量快速传值（适合单参数简单场景） #

直接修改package.json里的脚本，用shell的位置变量接收透传的参数：

{
  "scripts": {
    "build:docker": "tsc -b && sh dist.sh && docker build -t repo_name/image:$1 ."
  }
}

执行时只需要在--后紧跟要传的tag值即可：
npm run build:docker -- 1.0
此时--后第一个传入的1.0会被脚本里的$1捕获，直接作为镜像tag拼接在镜像名后。

方案2：npm内置配置变量传值（匹配你初始的写法） #

npm会自动把--key=value形式的透传参数，转换为带npm_config_前缀的环境变量注入脚本上下文，刚好可以适配你一开始设想的写法：
修改package.json的脚本内容，把自定义的$tag替换为npm自动注入的环境变量：

{
  "scripts": {
    "build:docker": "tsc -b && sh dist.sh && docker build -t repo_name/image:$npm_config_tag ."
  }
}

执行时直接传入带tag值的参数即可，和你最初的命令形式几乎一致：
npm run build:docker -- --tag=1.0
此时npm会自动把传入的tag=1.0映射为环境变量npm_config_tag=1.0，替换到docker build的tag参数位置。

避坑提示 #

• 分隔符--必须保留，漏写会导致参数被npm自身截留，无法传递到脚本内
• 引用环境变量时名称要完全匹配，比如传入的参数名是tag，脚本里就要对应写$npm_config_tag，大小写错误会直接拿到空值

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