如何解决安装@tensorflow-models/mobilenet时的npm依赖冲突问题？

执行npm install @tensorflow-models/mobilenet时出现的ERESOLVE错误，核心原因是peer依赖版本不兼容：当前项目已安装@tensorflow/tfjs-converter@4.1.0，但@tensorflow-models/mobilenet@2.1.0要求的peer依赖是@tensorflow/tfjs-converter@^3.1.0，两者版本范围冲突导致npm无法自动解析。

错误日志详情：

npm ERR! code ERESOLVE
npm ERR! ERESOLVE could not resolve
npm ERR! 
npm ERR! While resolving: undefined@undefined
npm ERR! Found: @tensorflow/tfjs-converter@4.1.0
npm ERR! node_modules/@tensorflow/tfjs-converter
npm ERR!   @tensorflow/tfjs-converter@"4.1.0" from @tensorflow/tfjs@4.1.0
npm ERR!   node_modules/@tensorflow/tfjs
npm ERR!     @tensorflow/tfjs@"^4.1.0" from the root project
npm ERR!   @tensorflow/tfjs-converter@"*" from the root project
npm ERR! 
npm ERR! Could not resolve dependency:
npm ERR! @tensorflow-models/mobilenet@"*" from the root project
npm ERR! 
npm ERR! Conflicting peer dependency: @tensorflow/tfjs-converter@3.21.0
npm ERR! node_modules/@tensorflow/tfjs-converter
npm ERR!   peer @tensorflow/tfjs-converter@"^3.1.0" from @tensorflow-models/mobilenet@2.1.0
npm ERR!   node_modules/@tensorflow-models/mobilenet
npm ERR!     @tensorflow-models/mobilenet@"*" from the root project
npm ERR! 
npm ERR! Fix the upstream dependency conflict, or retry
npm ERR! this command with --force or --legacy-peer-deps
npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
npm ERR! 
npm ERR! 
npm ERR! For a full report see:
npm ERR! /home/thesilentguy/.npm/_logs/2022-12-30T19_26_56_164Z-eresolve-report.txt

npm ERR! A complete log of this run can be found in:
npm ERR!     /home/thesilentguy/.npm/_logs/2022-12-30T19_26_56_164Z-debug-0.log

可行的解决方法： #

• 方法一：使用--legacy-peer-deps参数安装（推荐快速解决）
  该参数让npm采用旧版peer依赖解析逻辑，忽略版本冲突直接完成安装：

  npm install @tensorflow-models/mobilenet --legacy-peer-deps
  

• 方法二：统一tfjs相关包版本到兼容范围
  将@tensorflow/tfjs和@tensorflow/tfjs-converter降级到3.x版本，与mobilenet的peer依赖匹配：

  # 卸载现有不兼容版本
  npm uninstall @tensorflow/tfjs @tensorflow/tfjs-converter
  # 安装兼容版本的tfjs和mobilenet
  npm install @tensorflow/tfjs@3.21.0 @tensorflow-models/mobilenet
  

• 方法三：使用--force参数强制安装（不推荐）
  该命令会强制npm忽略依赖冲突完成安装，但可能导致运行时出现未知错误，仅适合测试场景临时使用：

  npm install @tensorflow-models/mobilenet --force
  

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