从Git安装Juice Shop执行npm install出现63个错误该如何解决

根因定位 #

• 环境版本不匹配：当前使用的Node.js v12.10.0、npm v8.0.0不符合Juice Shop v12.10.0的依赖要求，@angular系列依赖明确要求npm版本为^6.11.0 || ^7.5.6，版本不兼容触发后续编译规则异常
• 版本不兼容导致TypeScript编译校验规则错乱，最终抛出63个语法类错误

解决方案 #

方案1：切换匹配的Node.js/npm版本（推荐，可完全规避依赖问题） #

• 卸载当前Node.js v12.10.0，安装Node.js 14.x 配套 npm 6.x 版本，完全符合Juice Shop v12.10.0的依赖要求
• 清理原有依赖缓存与冗余文件：

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

• 重新执行安装命令即可：

npm install

方案2：临时兼容当前环境 #

如果暂时无法更换Node.js版本，可执行以下操作强制兼容：

• 先清理原有缓存和依赖文件，操作同上
• 执行安装时额外指定依赖兼容参数：

npm install --legacy-peer-deps

可选优化操作（非必须） #

• 安装完成后可执行npm audit fix修复已知低风险漏洞，不要随意添加--force参数，避免引入不兼容的破坏性变更
• 如果安装后启动失败，优先核查Node.js和npm版本是否匹配对应Juice Shop版本的要求

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