这里是阿里妈妈前端技术部,之前我们发布了基于代码转换工具 GoGoCode 的 Vue 转换插件(阿里妈妈又做了新工具,帮你把 Vue2 代码改成 Vue3 的),它能够帮你把项目里的 Vue2 的代码升级成 Vue3 的,但我们也收到很多朋友的反馈:我用了基于 Vue2 的 ElementUI ,它还没有支持 Vue3 ,我把我的业务代码升级上去也没法跑起来。
如今 ElementUI 的 Vue3 版本 Element Plus 已经正式发布了,它大部分兼容了 ElementUI 的 API ,但也存在着一些 breaking change,在两个团队的合作下,我们给大家带来 gogocode-element-plugin,它可以自动化地修改你的项目代码来适应所有的 breaking change ,大大减少你的升级工作量。
最后一块拼图已经拼上!
为了保证我们的转换规则能适配复杂场景,我们挑选了社区上火热的 Vue2 + ElementUI 项目 vue-element-admin,它覆盖了大多数 Vue2 和 Element 的用法,我们来试试通过转换插件把它转换成 Vue3 + Element Plus 的!
为了方便对比,我们接下来的命令会让转换工具覆写你原来的代码,建议你切换到一个新的分支操作,如果你的代码没有被 git 托管,请不要输出在同一目录。
git checkout -b to-vue3
npm install gogocode-cli -g
因为代码经过工具的 AST 修改后可能会发生格式的变化,所以建议预先把所有的源码用 prettier 格式化一遍,再和转换后的作对比就一目了然了。
gogocode -s ./src -t gogocode-plugin-prettier -o ./src
在提示是否覆盖源代码的时输入 y 回车即可
经过了 prettier 后,代码都被统一成了一样的格式:
把这个修改提交到 git 上
这次我们使用 gogocode-plugin-vue 插件把项目代码从 Vue2 升级到 Vue3:
gogocode -s ./src -t gogocode-plugin-vue -o ./src
这个项目有 258 个文件,转换程序卖力工作中:
转换完成!有 151 个文件发生了改动,这要是用手改头发可能就保不住了。
可以发现一些生命周期已经被转换了:
slot 和 filter 语法也不在话下:
函数式组件已经被改得面目全非了:
挨个文件看一遍,如果没什么大问题就 commit 并进入下一步!
一些可能需要手动修改的地方可以参考这个:需要关注的地方,不过建议你在最后能跑起来的时候再关心这些细节。
我们使用 gogocode-element-plugin 插件把项目代码从 ElementUI 升级到 Element Plus:
gogocode -s ./src -t gogocode-plugin-element -o ./src
这里是官方总结的:Element Plus 不兼容变化,gogocode-element-plugin 插件覆盖了几乎所有的规则。
这些只需要一次性、单文件的改动手动去做即可~
element-ui
换成 element-plus
如果使用了图标,别忘记 @element-plus/icons
也装上
import 'element-plus/theme-chalk/index.css'
每个人的构建环境不同,你可以通过下面的命令帮你更新 package.json 里面的 vue 和 vue-cli 的版本号:
gogocode -s ./src -t gogocode-plugin-vue -o ./src
我这里遇到了 Webpack4 升级到 Webpack5 的一些问题,具体参考了 vue-cli 升级文档 也都一一解决了。
运行项目,看看有哪些报错一一修复之,一些是第三方组件带来的,一些是构建带来的,对于这样体量的项目我大概修改了 100 多行的样子:commit
然后就见到了我期待的画面:
希望 GoGoCode 和配套的代码转换工具能帮助大家少做一些千篇一律的工作,早点下班回家,如果你在使用中遇到什么问题,欢迎通过以下方式联系我们:
issues: github.com/thx/gogocod…
钉钉群:34266233
最后:求 star 支持!
Github:github.com/thx/gogocod…(本项目在 packages/gogocode-plugin-element/ 目录下)
官网:gogocode.io
1
gouflv 2022-02-25 18:35:56 +08:00 via iPhone
看起来很完善。想不通 vue 官方为什么放弃 2-3 的迁移工具
|
3
cweijan 2022-02-26 16:14:07 +08:00
好酷!
|
4
bthulu 2022-02-27 15:39:32 +08:00
那么, vue3 是用 vue-cli, 还是 vite 呢?
感觉 vite 首次访问速度超级慢呀 |