代码 给 63 个 context 补上 pure 标记:Vite 8 里 VSelect 少打 73 kB,Vapor runtime 也不再进包

2026-11-18 21:05:37

给 63 个 context 补上 pure 标记:Vite 8 里 VSelect 少打 73 kB,Vapor runtime 也不再进包

来源:Vuetify 十月更新(发布于 2026 年 11 月 11 日)

v4.3.0(Paladin)在 10 月 19 日发布,第二天 Vuetify0 跟进 v1.3.0。如果你正在用 Vite 8 构建,升级前先刷新 lockfile,让 @vuetify/v0 解析到 v1.2.4 或更高——不用改任何业务代码,只用 VSelect 的应用 gzip 后能少约 23 kB(Vue 3.5)到约 73 kB(Vue 3.6)。

库变大了,打包产物反而变小

这次更新最反直觉的一点:v0 的代码量是往上走的,最终 chunk 却是往下走的。

原因在于 @vuetify/v0 在模块顶层无条件创建了 63 个 context。这些调用没有被标记为无副作用(side-effect free),打包器就必须保守地把它们全部保留下来——哪怕你的应用一个都没用到。v1.2.4 把这些调用逐个标成 pure,Vite 8 才能把未使用的部分 tree-shake 掉(#1043)。

于是最终产物只包含真正被引用到的代码,剩下的 63 个 context 里绝大多数都不再出现在 chunk 中。

依赖链:一个 VSelect 牵出全部 context

这条链子值得单独看清楚:

VSelect → VHighlight → v0 helper → 全部 63 个 context

VSelect 引用了 VHighlight,VHighlight 又引用了 v0 里的一个 helper,而这个 helper 所在的模块在顶层创建了所有 context。在 pure 标记缺失的情况下,打包器顺着这条链把整个 context 集合都当成有副作用的代码保留进了 chunk。

更麻烦的是 useId():它让整条链进一步引用了 vue 命名空间本身。在 Vue 3.6 上,这个命名空间里包含 Vapor runtime——也就是说,一个纯 VDOM 应用会被迫把 Vapor runtime 一起打进包里。

实测数据(Vite 8 生产构建,gzip 后 JS,单位 kB):

应用使用范围Vue 3.5Vue 3.6
仅使用 VSelect121 → 97171 → 98
全部组件244 → 221294 → 222

两种情况省下的体积几乎一样,因为被摇掉的代码本来就不是应用需要的。Vue 3.6 那一列的落差更大,多出来的部分正是被顺带拉进来的 Vapor runtime。

v1.3.1 直接切掉 Vue 3.6 那一块

v1.2.4 解决的是 context 的副作用标记问题,v1.3.1 则直接处理后一半:v0 不再以命名空间的形式导入 vue,VDOM 应用因此彻底不再携带 Vapor runtime(#1095)。使用 Vuetify v4.2.0 及以上版本的应用,在下一次依赖更新时就会拿到这一改动。

为什么 Vite 7 没有这个问题

Vite 7 的构建结果不受影响。两个版本对顶层副作用调用的处理行为不同:Vite 8 在模块顶层调用的保留与摇除策略更严格,未标记 pure 的调用会被完整保留;Vite 7 下的产物在这轮改动前后没有变化。所以这些节省只对 Vite 8 用户可见,不要用 Vite 7 的构建结果去验证升级效果。

操作建议

  1. 刷新 lockfile,确认 @vuetify/v0 解析到 >= 1.2.4:
npm update @vuetify/v0
# 或删掉 lockfile 重新安装
  1. 升级后跑一次生产构建,用 rollup / rolldown 的产物分析确认 vue 命名空间不再整体进入 chunk。重点看两处:一是未被引用的 context 是否已经消失,二是 VDOM 应用里是否还残留 Vapor runtime 相关代码。

  2. 只使用 VSelect 的应用可以作为基准对照,与上表的 97 kB(Vue 3.5)/ 98 kB(Vue 3.6)大致对齐。

同月的其他注意事项

  • labs 组件迁出:VAvatarGroup、VHighlight、VProgress 在 v4.3.0 已从 vuetify/labs 迁到 vuetify/components。继续从 vuetify/labs 导入会拿不到组件,需要改导入路径。

  • CDN 加载报错:通过 CDN 加载 v4.3.0 会抛出 process is not defined,升级到 v4.3.1 或更高版本即可(#23308)。

  • SSR 布局抖动修复:从 v4.3.0 起,服务端会预先渲染布局尺寸和偏移量(#23250),修复了 SSR 场景下的 layout shift。

除此以外,v4.3.0 还带来了右键菜单、新的 labs 组件、按钮 / 进度指示器 / 滑块 / 标签页的 MD3 选项,以及数据表格的一批小改进。

复制全文 生成海报 Vue 前端 构建

推荐文章

程序员茄子在线接单