用途:在出现包依赖冲突时提供排查与解决思路,适用于 npm、Yarn、pnpm 的安装失败、peer 依赖警告、Module not found、重复包警告、版本不匹配以及锁文件冲突等场景。
主要能力:识别常见错误类型,包括 peer 依赖冲突(如 ERESOLVE unable to resolve dependency tree)、版本范围不满足、同一包多版本共存;给出各包管理器的诊断命令,如 npm ls、npm why、npm outdated、npm audit,yarn list、yarn why、yarn dedupe --check,pnpm ls、pnpm why;并提供解决策略:升级到兼容版本、通过 overrides(npm/pnpm)或 resolutions(Yarn)强制指定版本、去重(npm dedupe、yarn dedupe)、以及在确认兼容后使用 --legacy-peer-deps、--force 或 --ignore-peer-deps 强制安装。还涉及追踪依赖链、查看包的 peerDependencies、处理原生模块重建、monorepo 工作区冲突和锁文件冲突(删除后重新生成)。
使用方式:先阅读完整报错信息,用诊断命令定位冲突来源,再按策略选择升级、覆盖或去重;锁文件冲突建议不手动合并,而是删除后重新安装;CI 中建议使用 npm ci。
限制:强制安装可能引发运行时错误,仅在验证兼容性后使用;资料未提供具体版本兼容矩阵、自动化修复工具或对非 JavaScript 生态的支持说明。