refactor:项目升级Vue3+uView Plus

- 改造入口文件、全量替换组件引入
- 过滤器迁移混入,更新忽略配置,新增迁移文档
This commit is contained in:
lifenlong
2026-06-06 22:51:10 +08:00
parent d5663cfb4d
commit f4337fd030
269 changed files with 1956 additions and 42350 deletions

40
VUE3_MIGRATION.md Normal file
View File

@@ -0,0 +1,40 @@
# Vue 3 升级说明
本项目已从 Vue 2 + uView 1.6 升级到 **Vue 3 + uView Plus**
## 环境要求
- HBuilderX 3.8+
- Node.js 16+(用于安装 `uview-plus``vuex@4``sass`
## 安装依赖
```bash
npm install
```
## 主要变更
| 项 | 变更 |
|---|---|
| `manifest.json` | 增加 `"vueVersion": "3"` |
| `main.js` | 使用 `createSSRApp` + `export function createApp()` |
| UI 库 | `uview-ui``uview-plus`npm 依赖) |
| 状态管理 | Vuex 4 `createStore` |
| 全局 filter | 改为 `main.js` 全局 mixin methods |
| 小程序分享 | `utils/mpShare.js` |
| u-cell-item | 改为 `u-cell` |
| u-verification-code | 改为 `u-code` |
| u-swipe-action | 内层增加 `u-swipe-action-item` |
| u-upload | 关闭 `auto-upload`,使用 `@afterRead` + `utils/uploadHelper.js` |
| u-parse | `:html` 改为 `:content`,移除 `show-with-animation` / `use-cache` |
## 编译
请使用 HBuilderX 分别运行到 **H5**、**微信小程序**、**App** 进行验证。
## 第三方插件
- `Sansnn-uQRCode`:声明支持 Vue3
- `u-draw-poster`:声明支持 Vue2/3
- `okingtz-cropper`:需在 App 端实测头像裁剪