使用TypeScript+Electron时npm安装报ERESOLVE依赖树错误如何解决？

报错信息：npm ERR! ERESOLVE unable to resolve dependency tree

1. 清理本地冗余依赖文件 #

• 删除项目根目录下的node_modules文件夹、package-lock.json文件，使用yarn的用户同步删除yarn.lock文件
• 执行npm缓存清理命令：npm cache clean --force

2. 定位具体冲突点 #

• 执行带详细日志的安装命令，输出完整冲突信息：npm install --verbose
• 重点核对两类依赖的版本兼容关系：
  • 项目声明的TypeScript版本和electron、electron-builder等工具链要求的TypeScript peer依赖版本范围是否匹配
  • 项目安装的@types/node版本和当前使用的Electron版本内置的Node.js版本是否一致
• 根据日志提示的兼容要求，修改package.json中对应依赖的版本号，对齐版本范围后重新执行安装

3. 强制忽略非致命冲突 #

如果调整版本后仍报错，可使用强制安装参数直接跳过peer依赖校验：
npm install --force
注意：该方案仅建议开发环境临时使用，生产环境请优先完成依赖版本对齐，避免后续出现运行时兼容性问题

4. 切换包管理器验证 #

如果npm安装始终失败，可尝试切换为其他包管理器安装：

• 使用pnpm：执行pnpm install
• 使用yarn：执行yarn install

可选临时方案 #

npm 7及以上版本默认开启严格peer依赖校验，你也可以选择将npm版本降级到6.x版本，从规则层面避免该类报错。

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