package.json脚本与终端相同npm命令行为差异原因解析

两个命令从底层执行逻辑上就完全不同，不存在等价关系。

为什么npm webpack会报未知命令 #

npm的命令解析规则是：当你执行npm <xxx>格式的命令时，npm只会按以下优先级查找可执行目标：

• npm自身内置的官方子命令，比如install、run、init、publish这类
• 全局安装的npm插件，一般是名为npm-xxx或者@npmcli/xxx的全局包

整个查找过程完全不会读取当前项目的package.json配置，也不会查找项目本地安装的依赖，而webpack既不是npm内置子命令，你也没安装对应的全局npm插件，自然会直接抛出Unknown command: "webpack"的错误。

npm run build的实际执行逻辑 #

当你执行npm run <脚本名>格式的命令时，npm会走完全独立的脚本执行流程：

1. 读取当前执行目录下package.json文件的scripts字段，匹配传入的脚本名，取出对应的待执行命令字符串，这里匹配到的就是webpack
2. 临时修改当前执行环境的PATH环境变量，将项目本地的node_modules/.bin目录插入到PATH的最优先级位置——这个目录下存放的是所有项目本地安装依赖暴露的可执行文件软链，也正因为这个修改，你不需要在scripts里写全路径./node_modules/.bin/webpack，直接写命令名就能优先调用本地安装的版本，不会误用全局安装的同名包
3. 在这个修改过PATH的独立shell环境中，直接执行取出的命令字符串，也就是运行webpack

你执行后收到需要安装webpack-cli的提示，恰好说明流程跑通了：npm已经成功从本地node_modules/.bin目录里找到了webpack的可执行文件并启动，只是webpack启动后自身检测到缺少配套的cli依赖，才抛出对应提示，和npm webpack的命令找不到错误完全是两个阶段的问题。

常见误区澄清 #

npm仅对极少数内置约定的脚本名做了免run的简写适配，只有npm start、npm test、npm stop、npm restart这几个命令可以省略run，等价于对应的npm run xxx。其余所有自定义脚本（包括你配置的build）都必须加run才能执行，直接写npm build也会报未知命令，更不用说直接写npm webpack——webpack甚至都不是你scripts里定义的脚本键名，npm不可能识别。

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