ECharts版本升级至5+，兼容性问题解决方案

将ECharts从原本的v4.9.0升级至于v5.5.0，在升级的过程中，由于大多数第三方插件尚未适配 ECharts 5+ 的模块路径变化，导致安装依赖时报错，如下

These dependencies were not found:

* echarts/lib/data/helper/completeDimensions in ./node_modules/echarts-liquidfill/src/liquidFillSeries.js, ./node_modules/echarts-wordcloud/src/WordCloudSeries.js

* echarts/lib/visual/dataColor in ./node_modules/echarts-liquidfill/src/liquidFill.js

To install them, you can run: npm install --save echarts/lib/data/helper/completeDimensions echarts/lib/visual/dataColor 

检查第三方插件兼容性,确认插件是否支持 ECharts 5+：
echarts-liquidfill: 最新版本需 >= 3.0（支持 ECharts 5+） 
echarts-wordcloud: 最新版本需 >= 2.0（支持 ECharts 5+） 
其他插件（如 echarts-gl）需同步升级

echarts-liquidfill 推荐版本
最新稳定版：3.1.0（适配 ECharts 5.5）
历史兼容版：2.0.6（适配 ECharts 4.9）

echarts-wordcloud 推荐版本
最新稳定版：2.0.0（适配 ECharts 5.5）
历史兼容版：1.1.3（适配 ECharts 4.9）

# 移除旧版
npm uninstall echarts echarts-liquidfill echarts-wordcloud
 
# 安装新版
npm install echarts@5.5.0 --save 

# 升级到支持 ECharts 5+ 的版本
npm install echarts-liquidfill@3.1.0 --save
npm install echarts-wordcloud@2.0.0 --save

//引用 ECharts
// 旧版写法（4.x）
import echarts from 'echarts';
// 新版写法（5.x）
import * as echarts from 'echarts';

// 按需引入
// 旧版写法（4.x）
import echarts from 'echarts/lib/echarts'
import 'echarts/lib/chart/bar'
 
// 新版写法（5.x）
import * as echarts from 'echarts/core'
import { BarChart } from 'echarts/charts'
echarts.use([BarChart]);


//按需引入优化,使用 ECharts 5 的 模块化按需引入 减少打包体积：
// 示例：按需引入折线图和提示框
import * as echarts from 'echarts/core'; // 核心模块
import { BarChart, LineChart } from 'echarts/charts'; // 图表类型 
import { TitleComponent, TooltipComponent } from 'echarts/components'; // 组件
import { CanvasRenderer } from 'echarts/renderers';  // 渲染器
 
// 注册必要组件
echarts.use([BarChart, LineChart, TitleComponent, TooltipComponent, CanvasRenderer]);

注意：当原项目有安装v-charts时，由于已是最新版本的v-charts@1.21.0 内部锁定 echarts@4.9.0 和 echarts-liquidfill@2.0.6，不支持 ECharts 5+，即

echarts5+版本 与 v-chart无法同时存在
若是强行升级 ECharts 会导致路径错误【如 datasetHelper 缺失】
建议移除v-charts或改用其他活跃库（如 vue-echarts）

# 移除旧库
npm uninstall v-charts

# 通过 npm 查看 v-charts 所有版本
npm view v-charts versions
npm info v-charts versions

 若升级失败想要返回到4.9.0版本

#卸载当前 ECharts 版本
npm uninstall echarts 

#安装 ECharts 4.9.0（稳定兼容版本）
npm install echarts@4.9.0 --save 

# 指定兼容旧版的插件版本
npm install echarts-liquidfill@2.0.6 --save  
npm install echarts-wordcloud --save 

#清除构建缓存并重启项目 或直接重启项目
npm run serve --force 

 常用命令

# 尝试验证缓存
npm cache verify
# 存在问题再强制清理 
npm cache clean --force  # 强制清理 npm 缓存
# 配合其他清理操作
rm -rf node_modules package-lock.json
npm install

#重新安装依赖
npm install --force

#构建前清理缓存
npm run build -- --no-cache

# 清理构建缓存
rm -rf node_modules/.cache

#项目构建
npm run build ---mode production --verbose
# 生产环境构建（默认模式，通常可省略）
npm run build -- --mode production
# 测试环境构建
npm run build -- --mode staging
# 自定义环境构建
npm run build -- --mode uat