Webpack与Webpack-cli版本兼容问题：为何指定4.9.2却尝试安装5.0.1？

核心原因 #

Webpack 5.75.0的**对等依赖（peerDependencies）**对webpack-cli的版本要求做了更新，指定了更高的版本范围（比如^5.0.0）。npm安装时会优先满足主依赖的对等依赖规则，即便你在package.json里明确指定了webpack-cli@4.9.2，它仍会尝试拉取符合Webpack 5.75.0要求的高版本。

另外，也可能是package-lock.json缓存了旧的依赖解析逻辑，或者存在依赖树冲突，导致npm解析时出现偏差。

解决办法 #

• 精确锁定版本：确保package.json里webpack-cli的版本号去掉^或~前缀，写成精确版本：

  "webpack-cli": "4.9.2"
  

  之后删除node_modules和package-lock.json，重新执行npm install。
• 覆盖对等依赖要求：在package.json中添加overrides字段（npm 8.3及以上版本支持），强制指定webpack-cli版本：

  "overrides": {
    "webpack-cli": "4.9.2"
  }
  

• 排查依赖树：执行npm ls webpack-cli查看完整依赖树，确认是否有其他依赖包间接要求webpack-cli@5.0.1，针对性调整该包的版本。
• 清理npm缓存：执行npm cache clean --force清除本地缓存后，再重新执行安装命令。

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