vlambda博客
学习文章列表

Vue2 彻底从 Flow 重构为 TypeScript,焕然一新!

事情起源于 4 月 7 号晚上,尤雨溪在推特说,Vue2 收到了一个将整个代码库迁移到 TypeScript 的 PR。
Evan's twitter

去 Github 围观了一下chore: move to typescript 这个 PR[1],基本上是 10w 行级别代码量的改动,把整个 Vue2 的代码库从原先的 flow 类型系统全部迁移到了 TypeScript,包括代码、构建系统、各种 lint 工具等等,恐怖的战斗力!

Vue2 彻底从 Flow 重构为 TypeScript,焕然一新!
Github PR

这个 PR 的贡献者是 Carlos Rodrigues[2],以下是他的自我介绍:

Fullstack developer, interested in @vuejs, @dotnet and @nodejs.

Typescript 🧙‍♂️

Consultant 🕵️‍♂️

全栈开发工程师,Vue.js、dotnet、Node.js 的爱好者。

TypeScript 魔法师 🧙‍♂️

顾问 🕵️‍♂️。

起源

Vue2 为什么最开始选择 Flow 作为类型系统?其实在一个 2016 年的知乎问题Vue 2.0 为什么选用 Flow 进行静态代码检查而不是直接使用 TypeScript?[3]里,尤雨溪已经详细说明了这个问题,以下是当时他的回答:

这个选择最根本的还是在于工程上成本和收益的考量。

Vue 2.0 本身在初期的快速迭代阶段是用 ES2015 写的,整个构建工具链也沿用了 Vue 1.x 的基于 ES 生态的一套(Babel, ESLint, Webpack, Rollup...),全部换 TS 成本过高,短期内并不现实。

相比之下 Flow 对于已有的 ES2015 代码的迁入/迁出成本都非常低:

  1. 可以一个文件一个文件地迁移,不需要一竿子全弄了。
  2. Babel 和 ESLint 都有对应的 Flow 插件以支持语法,可以完全沿用现有的构建配置;
  3. 更贴近 ES 规范。除了 Flow 的类型声明之外,其他都是标准的 ES。万一哪天不想用 Flow 了,用 babel-plugin-transform-flow-strip-types 转一下,就得到符合规范的 ES。
  4. 在需要的地方保留 ES 的灵活性,并且对于生成的代码尺寸有更好的控制力 (rollup / 自定义 babel 插件)

不过在 2018 年的时候,尤大更新了回答,真香定律再现:

Vue2 彻底从 Flow 重构为 TypeScript,焕然一新!
真香

也正因如此,Vue3 从一开始就选择了 TypeScript 作为类型系统。

困扰

那么也许有人要问,Vue2 不是已经稳定了吗,何必再大费周章的把这么多代码迁移到 TypeScript 中呢?其实在之前 中就有提及,之后还是会为 Vue 2.7 去加入一些和 Vue3 语法更类似的功能:

  • @vue/composition-api plugin [4]合并进 Vue2。这会让使用 Composition API 开发的库同时支持 Vue2 和 Vue3。
  • 单文件组件(SFC)中的 script setup [5]语法。
  • emits 选项。
  • 提升 TypeScript 类型支持。
  • 在 Vite 中正式支持 Vue 2(目前通过 非官方插件 [6])

而这些功能的开发和适配,如果继续用 flow 的话,势必会带来一些割裂的开发体验。一些已经用 TS 开发好的库,也没办法做代码的合并。事实上 Twitter 也有网友提出了这个问题,PR 作者进行了回答:

Vue2 彻底从 Flow 重构为 TypeScript,焕然一新!
Why

简单来说,就是为 Vue 2.7 的开发做准备,尤其是 composition-api 的代码合并。

具体内容

先看作者对这次更新的简单描述:

Vue2 彻底从 Flow 重构为 TypeScript,焕然一新!
  1. 代码格式化风格更新。
  2. 重构。
  3. 构建相关的改动。
  4. 代码库更新为 TypeScript 编写。

值得一提的是,更换成 TS 之后,生成的代码体积都有少量的增加,作者猜测是 TS 加入了一些 runtime 的代码导致的:

Vue2 彻底从 Flow 重构为 TypeScript,焕然一新!

第一个 Commit 中,作者把代码的类型全部改成 .ts,移除文件开头 flow 的标记,并且把类型的语法全部替换成 TypeScript:

Vue2 彻底从 Flow 重构为 TypeScript,焕然一新!

作者用 TS 的 import type 语法重构了类型导入,我个人也比较喜欢这样导入类型,更有助于区分导入的内容:

Vue2 彻底从 Flow 重构为 TypeScript,焕然一新!

单测工具的更新,以及 TS 的支持,利用 ts-loader 做编译:

Vue2 彻底从 Flow 重构为 TypeScript,焕然一新!

RollUp 版本的一次大升级:

Vue2 彻底从 Flow 重构为 TypeScript,焕然一新!

ESLint 也需要一些改动,使用 @typescript-eslint/parser,继承的一些推荐预设也改为 @typescript-eslint/eslint-recommended

Vue2 彻底从 Flow 重构为 TypeScript,焕然一新!

CI 中原本 flow 的类型检测,也改成使用 tsc --noEmit 做 TS 的类型检查。

Vue2 彻底从 Flow 重构为 TypeScript,焕然一新!

评价

可怕的是,这个如此庞大的 PR 是作者在几天内完成的,这战斗力简直是惊人。

Twitter 的评论中有人提问:“把如此巨大的代码库迁移到 TypeScript 需要多长时间?”

作者回答:在几小时内重命名文件,把 flow types 重写成 TS 类型并修复错误,之后的几天主要是忙构建、测试相关的工作。

Vue2 彻底从 Flow 重构为 TypeScript,焕然一新!

对此,外国推友也表示很震惊:

“你简直是个机器”:Vue2 彻底从 Flow 重构为 TypeScript,焕然一新!

“他生活的宇宙中,1 小时可以顶我们 24 小时,或者也可能他是用光速在敲代码”Vue2 彻底从 Flow 重构为 TypeScript,焕然一新!

CamiloR:“太棒了,很高兴核心团队之外,也有人付出如此多的努力”

Carlos:“我就是核心团队的成员 😆”

总结

不得不感叹,十倍工程师是真实存在的……这样一次巨型代码库迁移只花了短短几天时间,其实也体现出作者在 TS 生态、构建以及测试相关方面的熟悉程度。

感谢 Vue 核心团队成员们夸张的战斗力,给前端界带来这么优秀的框架而且持续迭代和优化。

Vue 3 虽然是未来,但是 Vue 2 也不会被放弃,迁移到 TS 以后的 Vue 2 具有更强的代码可移植性,一定会绽放出更多精彩。

参考资料

[1]

chore: move to typescript 这个 PR: https://github.com/vuejs/vue/pull/12001/commits

[2]

Carlos Rodrigues: https://twitter.com/pikax_dev

[3]

Vue 2.0 为什么选用 Flow 进行静态代码检查而不是直接使用 TypeScript?: https://www.zhihu.com/question/46397274/answer/101193678

[4]

@vue/composition-api plugin: https://github.com/vuejs/composition-api

[5]

script setup: https://github.com/vuejs/rfcs/pull/227

[6]

非官方插件: https://github.com/underfin/vite-plugin-vue2


前端真好玩
关注恺哥,前端进阶不再是难事。
135篇原创内容
Official Account