Vant 3.0 正式发布：全面拥抱 Vue 3

历经八个月时长的开发，Vant 3.0 终于和大家正式见面咯。在本次迭代中，我们的主要工作是基于 Vue 3 重构整个代码仓库和周边生态，并发布 Vant 3.0、Vant Cli 3.0 和 Vant Use 1.0。

回顾

按照惯例，我们先简单回顾一下 Vant 开源至今的成绩：

• 270 位开发者 参与了 Vant 和 VantWeapp 开发，并贡献了 4100 个 Pull Request
• 7300 个 issue 被关闭，99.3% 的 issue 得到解决或答复
• 站点月访问量 800 万次
• CDN 月下载量 3 亿次

更新内容

Vant 3.0：全面拥抱 Vue 3 ?

Vue 3 带来了许多激动人心的新特性，比如 Composition API、emits Option 和 Teleport。在 Vant 3.0 中，我们全面拥抱了 Vue 3 带来的各种变化，完成下列改造：

• 使用 Composition API 重构所有组件
• 使用 Composition API 重写所有文档和示例
• 组件增加 emits 选项，提供更好的事件提示
• 移除所有 mixins，提升代码可读性
• 所有弹窗类组件支持 teleport 属性

重构完成后，组件之间可以基于 Composition API 进行逻辑复用，代码的可压缩性也有所提升。与 Vant 2.12 版本进行对比，可以看到 Vant 3.0 的 JS 体积下降了 16.6%，Gzip 后体积下降至 67.5kb。

新组件：Vant 2、Vant 3 同步供应

Vant 3.0 中包含 3 个全新的组件，分别是：

• Badge 徽标：用于在右上角展示徽标数字或小红点。
• Popover 气泡弹出框：弹出式的气泡菜单组件。
• Cascader 级联选择器：用于多层级数据的选择，典型场景为省市区选择。

考虑到大部分开发者仍然在使用 Vue 2 进行开发，我们在 Vant 2 中同步实现了以上三个组件，大家可以升级到 Vant 2.12 版本进行使用。

Vant Use：新伙伴 ?

Vant Use 从 Vant 中沉淀出的 Composition API 库。除了提供常用的 Composition API 外，Vant Use 也会将某些组件的逻辑抽离出来，让开发者在使用组件逻辑的同时，能够完全自定义组件的展现形式。

下面是一个简单的例子，我们将 CountDown 组件的倒计时逻辑抽象为 useCountDown 方法，功能与 CountDown 组件基本等价，但使用起来更加灵活，我们可以自定义倒计时的 UI 样式，或者通过 computed 对倒计时进行预处理。

Vant Use 仍然处于早期阶段，在未来的演进过程中，我们会继续抽离 Vant 组件内部的通用逻辑，并下沉到 Vant Use 中。

Vant Cli 3.0：更新，更快 ?

Vant Cli 是 Vant 底层的组件库构建工具，通过 Vant Cli 可以快速搭建一套功能完备的 Vue 组件库。在 Vant Cli 3.0 中，我们对所有底层依赖进行了大版本升级，在支持 Vue 3 的同时，提供更流畅的开发体验。

• 升级 Vue 3、VueRouter 4、VueLoader 16
• 升级 Webpack 5，开启持久缓存能力
• 升级 Docsearch 3，全新的搜索框样式
• 升级 TypeScript 4、ESLint 7

在创建 vant-cli 工程时，你可以自由选择基于 Vue 2 或者 Vue 3 进行组件库开发：

Vant Demo：2 个新的示例工程

Vant Demo 是 Vant 官方提供的示例工程合集，在本次迭代中，我们新增了 2 个示例工程，分别演示：

• 如何使用 Vue 3 + Vant 3 + Vue Cli 搭建应用
• 如何使用 Vue 3 + Vant 3 + Vite 搭建应用

许多喜欢尝鲜的小伙伴已经在使用 Vite 进行开发了，在使用 Vite 的过程中，经常令大家困惑的一点是，如何在 Vite 中进行按需引入 Vant 组件。在 Vue Cli 中，我们可以通过 babel-plugin-import 插件实现按需引入，但在 Vite 中无法使用该插件。

其实在 Vite 中无须考虑按需引入的问题。Vite 在构建代码时，会自动通过 Tree Shaking 移除未使用的 ESM 模块。而 Vant 3.0 内部所有模块都是基于 ESM 编写的，天然具备按需引入的能力。现阶段遗留的问题是，未使用的组件样式无法被 Tree Shaking 识别并移除，后续我们会考虑通过 Vite 插件的方式进行支持。

开始尝鲜

目前，Vant 官网默认展示 Vant 2 的 API 文档，你可以通过官网右上角的版本切换按钮访问 Vant 3 的文档，也可以 ? 点此访问。

同时，Vant 的 npm latest 标签也保持在 v2 版本，这意味着使用 npm install vant 命令仍会安装 Vant 2，而安装 Vant 3 需要使用 npm install vant@next 命令。在 Vue 的默认文档版本和 npm 标签切换为 v3 后，我们也会同步进行切换。

从现有 Vant 2 项目升级，请参考 ? 升级指南。

下一步计划

未来 6 ~ 12 个月内，我们会保持 Vant 2 和 Vant 3 的功能同步更新。随着 Vue 3 的普及，我们会逐步降低 Vant 2 的维护频率，并将工作重心转移到 Vant 3 上。

另外，除了官方维护的 Vue 版本和微信小程序版本，Vant 也有由社区的小伙伴们发起和维护的 React 版本和支付宝小程序版本，欢迎大家一起参与建设 ?

不平凡的 2020 年即将过去，希望 Vant 能给大家的工作带来一点点的帮助，我们明年再会。