同一代码库多本地栈执行npm run publish报webpack: not found错误
排查与解决步骤
验证当前生效的运行环境路径
先在项目根目录依次执行以下命令,和另外3套正常环境的输出做对比:which node、which npm,确认当前激活的Node/npm路径完全一致ls -l node_modules/.bin/ | grep webpack,确认本地依赖的webpack可执行软链是否存在echo $PATH,检查PATH优先级顺序是否异常,是否有非NVM管理的Node路径(比如系统自带的/usr/bin/node)排在NVM的版本路径前面
确认NVM版本绑定与shell配置
执行nvm current查看当前激活的Node版本,是否和正常环境完全匹配;同时检查当前启动shell的配置(bash/zsh)是否正确加载了NVM的初始化脚本,避免出现“手动执行nvm use看似成功,但npm run spawn子进程时没有继承正确的NVM路径”的问题。如果存在shell配置差异,可以在当前终端先执行nvm use --delete-prefix强制刷新NVM路径后再执行命令。排查npm软链生成配置
本地安装的npm包默认会把可执行文件链接到node_modules/.bin目录,npm run执行脚本时会自动把这个目录加入临时PATH。如果软链没有正常生成,可执行以下命令检查配置:npm config get bin-links,正常返回true,如果是false,执行npm config set bin-links true开启软链生成npm config get ignore-scripts,正常返回false,如果是true,执行npm config set ignore-scripts false
配置调整完成后,删除node_modules和package-lock.json重新执行npm install即可。
排除全局依赖冲突
检查是否有残留的全局webpack占用PATH优先级:执行npm ls -g webpack查看全局安装的webpack版本,如果存在残留的无效全局路径,执行npm uninstall -g webpack清理后再重试。临时绕过方案
如果路径排查始终无法定位问题,可以直接修改package.json中publish命令的执行逻辑,改用Node直接调用webpack的入口文件,不依赖PATH查找:"publish": "node node_modules/webpack/bin/webpack.js --config 你的原有webpack配置参数"这种方式完全跳过软链和环境变量查找逻辑,可直接执行打包命令。
内容的提问来源于stack exchange,提问作者joegl
相关产品推荐
相关产品推荐

