#背景
公司有个项目使用vue2+js+webpack框架开发的,由于该项目内部需要安扫,导致很多框架出现了漏洞需要升级,其中主要需要从vue2升vue3,但是重新搭框架推翻重做成本太高,于是找到了gogocode。
#升级步骤踩坑
1. 安装 gogocode插件
pnpm install gogocode-cli -g
2. 使用迁移工具将代码从vue2转换到vue3
gogocode/packages/gogocode-plugin-vue at main · thx/gogocode · GitHub
gogocode -s ./src -t gogocode-plugin-vue -o ./src
./src为代码所在文件夹
3. 升级 Element 的引用代码
gogocode -s ./src -t gogocode-plugin-element -o ./src
4. 安装element-plus
pnpm install element-plus
5. 手动修改main.js 里引用
import ElementPlus from 'element-plus'import 'element-plus/dist/index.css'window.$vueApp = Vue.createApp(App) // 放在 import下第一行```其他文件注册引用...```window.$vueApp.mount("#app"); //放在最后一行
6. 依赖升级
gogocode -s package.json -t gogocode-plugin-vue -o package.json
7. 参照v-cli文档 迁移webpack相关配置
Migrate from v4 | Vue CLI
8. 升级eslint相关依赖版本及配置至支持vue3
https://eslint.vuejs.org/user-guide/
https://eslint.nodejs.cn/docs/latest/
9. 修复代码里的其他报错
a. 如在项目中引入了echarts依赖,在初始化时应使用markRaw
import { markRaw } from "vue";var myChart = markRaw(echarts.init(DOM));
b. Util中的公用方法用export导出在main中引用
import { functionA } from '@/utils'window.$vueApp.config.globalProperties.functionA = functionA
c. 替换不兼容组件
d. 根据报错提示修复代码
e. ts文件兼容js文件引入配置 (在tsconfig.json中配置,没有该文件就手动创建一个)
{ "compilerOptions": { "allowJs": true, // 允许编译JS文件 "outDir": "./dist" // 输出目录 }, "include": [ "./src/**/*" // 包含源代码目录 ] }
f. element-plus/icons引入icon报错
pnpm install @element-plus/icons-vuepnpm install -D unplugin-vue-components unplugin-auto-import