如何安装特定版本Ionic 4.13.11？升级项目遇冲突求助

核心问题说明 #

Ionic 4 开始将全局CLI和项目框架依赖拆分，旧命令npm install ionic@4.x不再适用，必须严格匹配全局CLI版本与项目@ionic/angular版本，否则会出现依赖冲突。

具体解决步骤 #

1. 匹配全局Ionic CLI版本 #

Ionic Framework 4.x 对应的全局CLI版本是5.x（CLI 6+对应Ionic 5+），先清理旧全局CLI再安装兼容版本：

• 卸载现有全局Ionic：npm uninstall -g ionic
• 安装适配Ionic 4.13.11的CLI版本：npm install -g ionic@5.4.16

2. 重构项目依赖 #

先清理旧依赖，再安装指定版本的框架包：

• 卸载旧的Ionic/Angular依赖：npm uninstall ionic angular
• 安装指定版本的@ionic/angular及对应Angular版本（Ionic 4.13.11需搭配Angular 8.x）：

  npm install @ionic/angular@4.13.11
  npm install @angular/core@8.2.14 @angular/common@8.2.14 @angular/compiler@8.2.14 @angular/platform-browser@8.2.14 @angular/platform-browser-dynamic@8.2.14 @angular/router@8.2.14
  

• 安装适配的工具包：npm install @ionic/angular-toolkit@2.1.2

3. 清理依赖缓存并重装 #

• 清理npm缓存：npm cache clean --force
• 删除本地依赖文件：rm -rf node_modules package-lock.json（Windows系统执行rmdir /s /q node_modules && del package-lock.json）
• 重新安装依赖：npm install

4. 锁定Node版本 #

Ionic 4.13.11 + Angular 8.x 仅兼容Node 10.x ~ 14.x，无需升级到16+，回到原版本即可：

• 用nvm切换版本：nvm use 14.17.0

额外注意事项 #

• Ionic 4 路由配置从app.module.ts迁移到app-routing.module.ts，需手动调整路由结构
• 页面组件的生命周期钩子有变更（如ionViewDidLoad改为ionViewDidEnter），需逐一适配

内容的提问来源于stack exchange，提问作者André Sartoreto