执行npm install构建p5.js时出现「Invalid Version:3.5.0pr2」错误

问题定位 #

3.5.0pr2不符合SemVer标准版本格式，这个非法版本号大概率藏在嵌套依赖的package.json中，而非项目顶层或直接依赖。结合你提供的依赖链信息，重点排查yuidocjs或其依赖的yui@3.18.1的子依赖树。

具体排查操作 #

1. 全量扫描依赖树定位问题包
   执行以下命令直接过滤出包含非法版本号的依赖：

   npm ls --all | grep "3.5.0pr2"
   

   该命令会输出具体的依赖路径，帮你快速定位到问题包。

2. 手动排查嵌套依赖
   如果上述命令无结果，进入node_modules/yui目录，逐层检查其package.json中声明的依赖，以及这些依赖的package.json版本字段，找到使用3.5.0pr2的包。

3. 检索package-lock.json
   在项目根目录的package-lock.json中全局搜索"3.5.0pr2"，找到对应的包名和依赖链。

修复方案 #

1. 强制替换非法版本（推荐）
   在项目根目录的package.json中添加resolutions字段，强制问题包使用合法的兼容版本（比如3.5.0）：

   "resolutions": {
     "问题包名": "3.5.0"
   }
   

   添加后重新执行npm install，npm会自动替换对应依赖的版本。

2. 升级相关依赖
   尝试升级grunt-contrib-yuidoc或yuidocjs到最新版本，新版本可能已经修复了依赖版本的问题：

   npm update grunt-contrib-yuidoc
   

   升级后删除旧的package-lock.json，重新执行npm install生成新的锁文件。

3. 临时应急方案（不推荐）
   若需快速跳过版本校验，可执行：

   npm install --force
   

   但该操作可能引发其他兼容性问题，仅建议临时使用。

额外验证步骤 #

执行以下操作彻底清理缓存和旧依赖，确保环境干净：

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

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