区分三大场景原生静态页面、Vue3 (Vite)、React (Vite)附带 Node 后端配套版本所有版本为长期稳定版不会出现 API 废弃、依赖冲突。一、通用基础库全项目通用兼容版本库名称稳定版本兼容说明axiosv1.7.x支持浏览器 / Node兼容 Vue2/3、React17/18无破坏性更新dayjsv1.11.x完全替代 momentAPI 一致无兼容性问题lodashv4.17.21最终稳定大版本不再更新全框架兼容zodv3.23.x表单 / 数据校验TS 完美支持Vue/React 通用xlsx(SheetJS)v0.18.xExcel 导入导出无依赖冲突gsapv3.12.x动画库轻量、无框架耦合echartsv5.4.x图表兼容所有前端环境vue-echarts/echarts-for-react 适配该版本crypto-jsv4.2.x前端加密clipboardv2.0.x复制文本二、Vue3 项目ViteVue3.4 主线稳定配套核心框架生态强制配套避免版本报错依赖包锁定版本配套规则vue3.4.x主框架不要升级 3.5 测试版vue-router4.2.x仅适配 Vue3和 vue3.4 完美兼容pinia2.1.xVue 官方状态库替代 vuex兼容 vue3.4vue-echarts6.6.x适配 echarts5.4.x配套使用UI 组件库兼容版本Element PlusPC 后台element-plus2.4.xVant4移动端 H5vant4.8.xVue3 完整安装命令复制直接用无冲突# 核心生态 npm install vue3.4.33 vue-router4.2.5 pinia2.1.7 # 通用工具 npm install axios1.7.4 dayjs1.11.10 lodash4.17.21 zod3.23.8 # 图表文件动画 npm install echarts5.4.3 vue-echarts6.6.1 xlsx0.18.5 gsap3.12.5 # PC UI npm install element-plus2.4.9三、React 项目ViteReact18 稳定主线核心框架生态配套版本依赖包锁定版本兼容说明react / react-dom18.2.x主流稳定版不推荐 19 测试版react-router-dom6.20.x适配 react18路由 API 统一zustand4.4.x轻量状态管理无冗余依赖echarts-for-react3.0.2适配 echarts5.4.xUI 组件库兼容版本Ant Design企业后台antd5.12.xMUI 谷歌风格mui/material5.15.xReact 完整安装命令直接复制# 核心框架路由状态 npm install react18.2.0 react-dom18.2.0 react-router-dom6.20.0 zustand4.4.7 # 通用工具 npm install axios1.7.4 dayjs1.11.10 lodash4.17.21 zod3.23.8 # 图表、Excel、动画 npm install echarts5.4.3 echarts-for-react3.0.2 xlsx0.18.5 gsap3.12.5 # Ant Design后台UI npm install antd5.12.2四、Node.js 后端Express / NestJS 版本兼容1. Express 轻量后端稳定组合# 框架基础 npm install express4.18.2 cors2.8.5 body-parser1.20.2 # 文件上传、数据库、鉴权 npm install multer1.4.5-lts.1 mysql23.6.5 jsonwebtoken9.0.2 joi17.11.02. NestJS 企业级 TS 后端配套# ORM数据库 npm install nestjs/typeorm10.0.1 typeorm0.3.17 mysql23.6.5 # JWT登录鉴权 npm install nestjs/jwt10.2.0 nestjs/passport10.0.2 passport-jwt4.0.1 # 参数校验 npm install class-validator0.14.0 class-transformer0.5.1五、版本冲突避坑规则重点echarts 配套规则echarts5.x 必须搭配 vue-echarts6.x/echarts-for-react3.x 不要混用 echarts4.xAPI 差异极大。框架大版本隔离Vue2 不能安装 vue-router4、piniaVue3 不兼容 vue-router3、vuex 旧版React17 项目不要直接升级 antd5会出现组件渲染报错Lodash TS 类型包TS 项目额外安装类型提示版本固定npm install -D types/lodash4.14.200不要使用 ^、~ 模糊版本生产环境建议锁定版本package.json写死版本号避免自动升级大版本引发线上 bug。打包工具兼容Vite4.x 适配 Vue3.4、React18Webpack5 可兼容以上所有库无冲突。六、CDN 引入版本原生静态页面稳定 CDN 地址html!-- 基础工具 -- script srchttps://cdn.jsdelivr.net/npm/axios1.7.4/dist/axios.min.js/script script srchttps://cdn.jsdelivr.net/npm/dayjs1.11.10/dayjs.min.js/script script srchttps://cdn.jsdelivr.net/npm/lodash4.17.21/lodash.min.js/script !-- 图表 -- script srchttps://cdn.jsdelivr.net/npm/echarts5.4.3/dist/echarts.min.js/script
JS 各项目库版本兼容清单（稳定无冲突，2026 推荐）
区分三大场景原生静态页面、Vue3 (Vite)、React (Vite)附带 Node 后端配套版本所有版本为长期稳定版不会出现 API 废弃、依赖冲突。一、通用基础库全项目通用兼容版本库名称稳定版本兼容说明axiosv1.7.x支持浏览器 / Node兼容 Vue2/3、React17/18无破坏性更新dayjsv1.11.x完全替代 momentAPI 一致无兼容性问题lodashv4.17.21最终稳定大版本不再更新全框架兼容zodv3.23.x表单 / 数据校验TS 完美支持Vue/React 通用xlsx(SheetJS)v0.18.xExcel 导入导出无依赖冲突gsapv3.12.x动画库轻量、无框架耦合echartsv5.4.x图表兼容所有前端环境vue-echarts/echarts-for-react 适配该版本crypto-jsv4.2.x前端加密clipboardv2.0.x复制文本二、Vue3 项目ViteVue3.4 主线稳定配套核心框架生态强制配套避免版本报错依赖包锁定版本配套规则vue3.4.x主框架不要升级 3.5 测试版vue-router4.2.x仅适配 Vue3和 vue3.4 完美兼容pinia2.1.xVue 官方状态库替代 vuex兼容 vue3.4vue-echarts6.6.x适配 echarts5.4.x配套使用UI 组件库兼容版本Element PlusPC 后台element-plus2.4.xVant4移动端 H5vant4.8.xVue3 完整安装命令复制直接用无冲突# 核心生态 npm install vue3.4.33 vue-router4.2.5 pinia2.1.7 # 通用工具 npm install axios1.7.4 dayjs1.11.10 lodash4.17.21 zod3.23.8 # 图表文件动画 npm install echarts5.4.3 vue-echarts6.6.1 xlsx0.18.5 gsap3.12.5 # PC UI npm install element-plus2.4.9三、React 项目ViteReact18 稳定主线核心框架生态配套版本依赖包锁定版本兼容说明react / react-dom18.2.x主流稳定版不推荐 19 测试版react-router-dom6.20.x适配 react18路由 API 统一zustand4.4.x轻量状态管理无冗余依赖echarts-for-react3.0.2适配 echarts5.4.xUI 组件库兼容版本Ant Design企业后台antd5.12.xMUI 谷歌风格mui/material5.15.xReact 完整安装命令直接复制# 核心框架路由状态 npm install react18.2.0 react-dom18.2.0 react-router-dom6.20.0 zustand4.4.7 # 通用工具 npm install axios1.7.4 dayjs1.11.10 lodash4.17.21 zod3.23.8 # 图表、Excel、动画 npm install echarts5.4.3 echarts-for-react3.0.2 xlsx0.18.5 gsap3.12.5 # Ant Design后台UI npm install antd5.12.2四、Node.js 后端Express / NestJS 版本兼容1. Express 轻量后端稳定组合# 框架基础 npm install express4.18.2 cors2.8.5 body-parser1.20.2 # 文件上传、数据库、鉴权 npm install multer1.4.5-lts.1 mysql23.6.5 jsonwebtoken9.0.2 joi17.11.02. NestJS 企业级 TS 后端配套# ORM数据库 npm install nestjs/typeorm10.0.1 typeorm0.3.17 mysql23.6.5 # JWT登录鉴权 npm install nestjs/jwt10.2.0 nestjs/passport10.0.2 passport-jwt4.0.1 # 参数校验 npm install class-validator0.14.0 class-transformer0.5.1五、版本冲突避坑规则重点echarts 配套规则echarts5.x 必须搭配 vue-echarts6.x/echarts-for-react3.x 不要混用 echarts4.xAPI 差异极大。框架大版本隔离Vue2 不能安装 vue-router4、piniaVue3 不兼容 vue-router3、vuex 旧版React17 项目不要直接升级 antd5会出现组件渲染报错Lodash TS 类型包TS 项目额外安装类型提示版本固定npm install -D types/lodash4.14.200不要使用 ^、~ 模糊版本生产环境建议锁定版本package.json写死版本号避免自动升级大版本引发线上 bug。打包工具兼容Vite4.x 适配 Vue3.4、React18Webpack5 可兼容以上所有库无冲突。六、CDN 引入版本原生静态页面稳定 CDN 地址html!-- 基础工具 -- script srchttps://cdn.jsdelivr.net/npm/axios1.7.4/dist/axios.min.js/script script srchttps://cdn.jsdelivr.net/npm/dayjs1.11.10/dayjs.min.js/script script srchttps://cdn.jsdelivr.net/npm/lodash4.17.21/lodash.min.js/script !-- 图表 -- script srchttps://cdn.jsdelivr.net/npm/echarts5.4.3/dist/echarts.min.js/script
