给 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.5 | Vue 3.6 |
|---|---|---|
| 仅使用 VSelect | 121 → 97 | 171 → 98 |
| 全部组件 | 244 → 221 | 294 → 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 的构建结果去验证升级效果。
操作建议
- 刷新 lockfile,确认
@vuetify/v0解析到>= 1.2.4:
npm update @vuetify/v0
# 或删掉 lockfile 重新安装
升级后跑一次生产构建,用 rollup / rolldown 的产物分析确认
vue命名空间不再整体进入 chunk。重点看两处:一是未被引用的 context 是否已经消失,二是 VDOM 应用里是否还残留 Vapor runtime 相关代码。只使用 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 选项,以及数据表格的一批小改进。