创建Ionic新项目遇npm ERESOLVE依赖树解析失败，常规尝试无效求解决

核心报错原因 #

• npm从7版本开始强化了peer依赖的强制校验逻辑，遇到依赖版本不兼容的场景不会自动跳过安装，直接抛出ERESOLVE unable to resolve dependency tree错误。
• 常规的强制清缓存、在项目创建命令末尾追加--force/--legacy-peer-deps的操作无法生效，本质是这类参数仅能作用于项目目录下的依赖安装环节，无法解决全局Ionic CLI版本与本地Node环境不兼容的问题；脚手架往往在拉取初始模板、触发全局依赖校验的阶段就已经报错中断，根本走不到参数生效的安装流程。

可落地的修复步骤 #

• 卸载本地全局残留的旧版本Ionic CLI，执行命令：npm uninstall -g @ionic/cli
• 校验本地Node版本的兼容性：Ionic v6、v7系列稳定版脚手架，适配的Node长期支持版本区间为16.13.0 ~ 20.10.0，若当前Node版本不在该区间内，切换至匹配的LTS版本后再操作，过大的Node版本差是触发依赖树冲突的高频原因。
• 确认npm缓存无残留后，重新安装稳定版Ionic CLI，执行命令：npm install -g @ionic/cli@stable，安装完成后可通过ionic --version验证CLI是否正常加载。
• 执行项目初始化命令时，将兼容参数传入脚手架的全流程逻辑，避免参数未触达依赖安装环节：执行命令ionic start 自定义项目名称 blank --type=angular --legacy-peer-deps，让参数覆盖从模板拉取到依赖安装的全链路流程。
• 补充排障：如果完成上述步骤后仍触发同类报错，可检查全局npm目录下是否存在残留的旧版本Capacitor、Cordova包，这类包的版本要求和新脚手架的依赖规则冲突时，会直接阻断依赖解析流程；确认不需要的残留包可通过npm uninstall -g 对应包名卸载后重试。

内容的提问来源于stack exchange，提问作者Muhammad Usman