VS Code项目启动失败：npm依赖解析错误（webpack版本不兼容）

报错信息 #

无法解析依赖项：
npm ERR! peer webpack@"5.x.x" from @webpack-cli/serve@2.0.5

错误截图显示该peer依赖不匹配的详细报错内容。

解决步骤 #

• 检查当前webpack版本：执行命令 npm list webpack，确认项目中已安装的webpack版本是否为5.x.x系列。
• 升级webpack到兼容版本：运行 npm install webpack@^5.0.0 --save-dev，将webpack升级到5.x.x稳定版，满足@webpack-cli/serve@2.0.5的peer依赖要求。
• 重置依赖环境（若升级后仍报错）：删除项目根目录下的node_modules文件夹和package-lock.json文件，执行 npm cache clean --force 清理缓存，再重新运行 npm install 安装所有依赖。
• 临时应急方案（不推荐长期使用）：若暂时无法升级webpack，可执行 npm install --legacy-peer-deps 或 npm install --force 强制跳过peer依赖检查，但可能引发其他兼容性问题。

内容的提问来源于stack exchange，提问作者Junaid Azhar