#背景

公司有个项目使用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-vue

pnpm install -D unplugin-vue-components unplugin-auto-import