安装@tensorflow-models/face-landmarks-detection npm包时遇依赖冲突错误

问题根源 #

这是npm peer依赖版本冲突导致的：

• @tensorflow-models/face-landmarks-detection@1.0.2 要求 @tensorflow/tfjs-backend-webgl@^3.12.0
• 但它依赖的 @tensorflow-models/face-detection@1.0.2 要求 @tensorflow/tfjs-backend-webgl@^4.4.0
  两个版本范围不兼容，而npm 7+默认严格校验peer依赖，因此抛出ERESOLVE错误。

解决方案 #

1. 快速解决：使用legacy-peer-deps参数

直接运行带参数的安装命令，让npm采用npm 6的peer依赖处理逻辑，忽略版本冲突：

npm install @tensorflow/tfjs @tensorflow-models/face-landmarks-detection --legacy-peer-deps

该方法适合快速推进开发，tensorflow生态的包通常对小版本差异兼容性较好。

2. 稳妥方案：锁定兼容版本组合

指定与face-landmarks-detection@1.0.2完全匹配的tfjs版本，确保依赖链版本一致：

npm install @tensorflow/tfjs@3.12.0 @tensorflow-models/face-landmarks-detection@1.0.2

此命令会安装3.12.0版本的tfjs及对应backend，完全满足face-landmarks-detection的peer依赖要求，同时face-detection@1.0.2也能兼容该版本。

3. 升级到最新包版本

如果项目允许，安装最新版的face-landmarks-detection，新版本通常会同步依赖版本要求，解决冲突：

# 查看最新版本
npm show @tensorflow-models/face-landmarks-detection version
# 安装最新版
npm install @tensorflow/tfjs @tensorflow-models/face-landmarks-detection@latest

4. 清理缓存后重试

若之前重装无效，先清理npm缓存和旧依赖文件：

# 清理npm缓存
npm cache clean --force
# 删除node_modules和锁文件（Windows替换为rd /s /q node_modules package-lock.json）
rm -rf node_modules package-lock.json
# 再用上述任一方案重新安装

内容的提问来源于stack exchange，提问作者Yasika Hivin Gunathilaka