lilishop-ui/im/MIGRATION-VUE3.md

IM 客服端 Vue 3 迁移说明

技术栈

• Vue 3.5 + Vue Router 4 + Vuex 4
• Element Plus（替代 element-ui）
• 自研右键菜单 src/plugins/contextmenu.js（替代 vue-contextmenujs）
• vue-virtual-scroller@3、vue-cropper@1.x、vue-prism-editor@2.0.0-alpha.2

启动

cd im
yarn install
yarn dev    # 端口 8000
yarn build

迁移要点

1. 入口 src/main.js — createApp，全局过滤器 $filters
2. 路由 createRouter + createWebHistory，404 路由 /:pathMatch(.*)*
3. 通知 im-server/event/talk.js 通过 app-bridge 发 ElNotification，避免循环引用
4. 用户卡片 $user() 插件用 createApp 挂载
5. 指令 v-focus / v-paste / v-drag / v-outside 已改为 Vue 3 钩子
6. SVG svg-sprite-loader + svg-icon 全局组件
7. 生命周期 destroyed → beforeUnmount；$set / $delete 已移除

上线前检查

统一清单见仓库根目录：../MIGRATION-VUE3.md
IM 专项见该文档 「IM 客服端」 一节。