Node.js v6.x.x环境下npm install报错Unsupported URL Type求助

问题根源 #

Node.js v6.x.x配套的npm版本（通常为3.x.x）过于老旧，无法识别npm:string-width@^4.2.0这类新型依赖引用格式——该语法是后续npm版本才支持的特性，老版本npm会将其判定为无效URL类型。而v20.x.x的npm虽能识别该格式，但项目代码依赖Node.js v6的API，因此启动失败。

解决方案 #

1. 降级问题依赖版本

打开项目的package.json，处理涉及npm:string-width@^4.2.0的依赖项：

• 若为直接依赖：将"string-width": "npm:string-width@^4.2.0"修改为"string-width": "^2.1.1"（v2.x版本完全兼容Node.js v6）
• 若为间接依赖：通过npm-shrinkwrap.json锁定子依赖版本，执行命令生成锁定文件：

  npm shrinkwrap --dev
  

  打开生成的npm-shrinkwrap.json，找到对应string-width的条目，将版本修改为^2.1.1。

2. 安装Node.js v6兼容的npm版本

Node.js v6.x.x最高适配npm 3.10.10，切换到v6版本后执行以下命令：

npm install -g npm@3.10.10

完成后清理缓存并重新安装依赖：

npm cache clean --force
rm -rf node_modules
npm install

3. 移除--force参数

--force会跳过兼容性检查，可能引发更多潜在问题，调整完成后直接执行npm install即可。

验证 #

完成上述操作后重新执行npm install，依赖应能正常安装，随后运行npm start即可启动项目。

内容的提问来源于stack exchange，提问作者Jan Mareš