👁 46 次阅读
为什么 rolldown-vite 构建更快但产物体积反而增大 31%?
来源链接:https://github.com/vitejs/vite/issues/21944现象描述
一个使用 Vite + Svelte + LightningCSS 的小型项目(Github-Releases-Feed)在从 Vite 6.3.5 切换到 rolldown-vite 6.3.18 后,出现了显著的构建性能提升和产物体积恶化现象。 使用time yarn build 测量真实墙钟时间,数据对比如下:
| 构建工具 | 构建耗时 | JS 产物体积 | gzip 后体积 |
| Vite 6.3.5 | 0.909s | 62.62 kB | 23.16 kB |
| rolldown-vite(enableNativePlugin=false) | 0.773s | 81.97 kB | 29.30 kB |
| rolldown-vite(enableNativePlugin=true) | 0.657s | 81.97 kB | 29.29 kB |
| 构建性能提升约 15%(关闭原生插件)至 28%(开启原生插件),但产物体积在两种配置下都增大了约 31%(从 62.62 kB 增长到 81.97 kB)。应用代码本身没有任何改动,项目规模较小且不存在明显死代码,因此问题被初步指向 tree-shaking 行为差异。 | |||
背景原因 | |||
| issue 创建者最初推测是某些依赖库没有被正确 tree-shake。随着讨论推进,社区成员逐渐定位到两个方向: | |||
| 方向一:常量内联(inlineConst)缺失 | |||
用户 IWANABETHATGUY 在 2025-07-05 的评论中指出,rolldown 的 PR #5165 合并后,开启 optimization.inlineConst 配置可将产物从 81.97 kB 降至 72.50 kB: | |||
| |||
| 当 rolldown-vite 和 rollup-vite 都使用 terser 作为 minifier 时,rolldown-vite + inlineConst 的产物进一步缩小到 64.83 kB(gzip 23.58 kB),已接近原始 Vite 的体积水平。 | |||
| 方向二:sideEffects 声明与导入保留 | |||
用户在 2026-02-03 的评论中提供了一个关键线索:@codemirror/xxx 系列包在 package.json 中声明了 "sideEffects": false,但未使用的导入仍然被保留在产物中。用户提供了 rolldown playground 复现链接,并测试了最激进的 tree-shaking 配置: | |||
| |||
| 即使在这种配置下,多余的导入仍然无法被消除。 | |||
排查或量化方法 | |||
实验对比法:在同一仓库中分别运行 vite build 和 rolldown-vite build,使用系统 time 命令而非构建工具自带报告时间,以获得包含全部进程开销的真实耗时。 | |||
变量控制:保持应用代码不变,仅切换构建工具。对比两种 enableNativePlugin 配置(false 和 true),排除插件系统差异对体积的影响。 | |||
| minifier 对照:当 rolldown-vite 与 rollup-vite 都使用 terser 作为 minifier 时,rolldown-vite + inlineConst 的产物为 64.83 kB(gzip 23.58 kB),已经与原始 Vite 的 62.62 kB(gzip 23.16 kB)非常接近。这说明默认 minifier 的差异也是体积增大的来源之一。 | |||
| 依赖包定位:通过 custom plugin 移除引入 codemirror 的代码后,重新对比 Vite 7.3.1 与 8.0.0-beta.13 在 immich@e6eca895b 上的构建产物。该实验显示服务端 JS 从 16519159 字节降至约 15762519 字节,客户端 JS 从约 15762519 字节降至约 345914 字节(CSS),证明 codemirror 相关依赖的导入保留对体积有显著影响。 | |||
| 升级回归对比:用户 kevpye-fabdata 在 2026-03-25 报告,一个较大的 SvelteKit 项目从 Vite 7 升级到 Vite 8 后,最大 chunk 从 700Kb 暴增至 3500Kb,且无任何代码变更。这与 codemirror 场景高度相似,进一步佐证了 sideEffects 处理差异的普遍性。 | |||
完整解决方案(含必要代码) | |||
| 据 issue 讨论,当前存在以下缓解路径: | |||
| 路径一:开启 inlineConst 优化 | |||
在 rolldown-vite 配置中启用 optimization.inlineConst: | |||
| |||
| 该配置配合 terser minifier 可将产物从 81.97 kB 降至 64.83 kB(gzip 23.58 kB),与原始 Vite 体积基本持平。但需要注意,该方案基于 rolldown PR #5165 合并后的版本。 | |||
| 路径二:使用 custom plugin 剔除多余依赖 | |||
| 用户 dominikg 在 gist 中发布了一个 custom plugin,用于移除会拉入 codemirror 的代码。在 immich 项目中,该插件可将服务端 JS 从 16519159 字节降至约 15762519 字节。该方案可视为依赖级的手术式修复,但需要针对具体项目定制。 | |||
| 路径三:等待上游修复 | |||
| 相关修复涉及多个上游项目: | |||
| – https://github.com/oxc-project/oxc/issues/11454 | |||
| – https://github.com/rolldown/rolldown/issues/4786 | |||
| – https://github.com/oxc-project/oxc/issues/10033 | |||
| – https://github.com/rolldown/rolldown/issues/8195 | |||
其中 rolldown/rolldown#8195 被多个用户(包括在 sanity 包的 "sideEffects": false 场景中)视为可能解决 codemirror 类问题的基础修复。用户在 2026-04-23 的评论中指出,svelte 应用仍受 rolldown/rolldown#8195 影响,在 Vite 8.0.10 下使用 custom plugin 剥离 onmount 后服务端构建产物仍有体积差异。 | |||
参数或对比表格 | |||
| 不同配置下的构建产物对比(Vite vs rolldown-vite): | |||
| 配置组合 | JS 产物 | gzip | 备注 |
| Vite 6.3.5(默认) | 62.62 kB | 23.16 kB | 基线 |
| rolldown-vite 6.3.18(enableNativePlugin=false) | 81.97 kB | 29.30 kB | 体积 +31% |
| rolldown-vite 6.3.18(enableNativePlugin=true) | 81.97 kB | 29.29 kB | 体积 +31% |
| rolldown-vite 7.0.4(inlineConst) | 72.50 kB | 26.34 kB | 较 6.3.18 改善 |
| rolldown-vite(inlineConst + terser) | 64.83 kB | 23.58 kB | 接近基线 |
| Vite(terser minifier) | 未完整给出 | — | 对照实验 |
| immich 项目中 custom plugin 效果(Vite 7.3.1 vs 8.0.0-beta.13): | |||
| 构建目标 | 7.3.1 | 8.0.0-beta.13(带 plugin) | |
| server-js | 16519159 | 15762519 | |
| client-js | 15762519 | — | |
| client-css | 345914 | — |
常见错误排查
错误 1:只关注构建工具自报的 build time 构建工具报告的 “built in” 时间只覆盖打包过程,不包含进程启动、配置加载、依赖解析等开销。应使用系统级time 命令测量完整墙钟时间。
错误 2:直接升级到 Vite 8 未做体积回归验证
kevpye-fabdata 报告 SvelteKit 项目在 Vite 7 到 Vite 8 升级后,最大 chunk 从 700Kb 增至 3500Kb。任何跨大版本升级都应在预发布环境对比产物体积。
错误 3:对声明了 "sideEffects": false" 的包过度信任
codemirror 系列包虽然在 package.json 中声明了无副作用,但实际导入未被 tree-shake。sideEffects 声明是包的作者声明,工具链是否严格遵循该声明取决于实现。对于大型依赖树,应抽查产物中是否有未使用导入残留。
错误 4:将默认 minifier 差异与 tree-shaking 差异混为一谈
在 issue 讨论中,当 rolldown-vite 与 rollup-vite 都使用 terser 作为 minifier 时,体积差距显著缩小(81.97 kB 降至 64.83 kB)。这说明 minifier 的选择是体积差异的一个来源,但 issue 中并未给出两者默认 minifier 的具体归属判断,minifier 差异只是因素之一而非全部原因。
错误 5:把 open 状态的议题当成已有结论
该 issue 当前状态为 open(关闭原因:reopened),表明官方尚未提交修复方案。社区提供的 inlineConst、custom plugin 均为变通方案,不等同于框架层修复。
实践建议
- 使用 rolldown-vite 或 Vite 8 时,将
optimization.inlineConst纳入默认配置,并考虑统一使用 terser 作为 minifier,以缩小与 Vite 7 的体积差距。 - 对大型项目执行升级时,建立产物体积的自动化回归检查。对比项应包含总 JS 体积、最大 chunk 体积、gzip 后体积三个维度。
- 若项目依赖 codemirror、sanity 等声明了
"sideEffects": false"的包,建议先检查产物中是否残留未使用导入。可以通过构建产物搜索特定包名或函数名进行抽查。 - 关注 rolldown/rolldown#8195 的进展。该 issue 被多个用户认为与 sideEffects 导入保留直接相关,修复后可能解决 codemirror、sanity 等场景的体积膨胀问题。
- 在官方修复合入前,可使用 custom plugin 针对具体依赖进行剥离。dominikg 在 gist 中发布的 plugin 可作为参考模板,但需要根据项目依赖树定制匹配规则。
FAQ
Q:rolldown-vite 的构建产物一定比 Vite 大吗? A:不是必然。在本 issue 的案例中,体积增大与常量内联缺失和 sideEffects 导入保留有关。开启 inlineConst 并将 minifier 切换为 terser 后,产物体积已接近原始 Vite(64.83 kB vs 62.62 kB)。具体表现取决于项目依赖结构。 Q:enableNativePlugin 的 true/false 对体积有影响吗?
A:在本 issue 的测试中,两种配置的 JS 产物均为 81.97 kB,gzip 后分别为 29.30 kB 和 29.29 kB,差异可忽略。该参数主要影响构建性能(true 时构建更快),不影响产物内容。
Q:Vite 8 升级后体积暴增是什么原因?
A:用户在 2026-03-25 报告 SvelteKit 项目从 Vite 7 到 Vite 8 升级后最大 chunk 从 700Kb 增至 3500Kb。据 issue 讨论,这与 codemirror 场景同源,即 rolldown 在处理声明 "sideEffects": false" 的包时保留了未使用导入。具体根因追踪到 rolldown/rolldown#8195。
Q:issue 关闭了吗?
A:issue 当前状态为 open。2026-04-23 时维护者 sapphi-red 澄清关闭是误操作(本意是移入个人项目),并非有意关闭。同日的末条实质评论指出 svelte 应用仍受 rolldown/rolldown#8195 影响,在 Vite 8.0.10 下仍有体积差异。
Q:有没有官方确认的修复版本?
A:没有。issue 状态为 open,官方未提交修复方案。社区侧已确认 inlineConst 和 terser 组合可显著缩小体积差距,custom plugin 可针对特定依赖进行剥离,但这些都是变通方案而非框架层修复。
🔗 相关阅读(你可能还想看)
📄 如何在GEO中实现GuardrailProvider接口的预工具调用授权?
📄 如何在GEO中实现宏录制功能?
📄 ShadCN v4 按钮悬停时指针光标消失,问题根源在哪?
📄 Next.js 生产环境 CSS 顺序错乱问题如何根治?
📄 Outlook 节点创建草稿添加附件为何报 UnableToDeserializePostBody?
📄 Flowise 点击市场或聊天页为何整页白屏?
📄 如何解决 Azure AI Search 向量存储的 $filter 递归深度超限错误?
📄 如何解决 shadcn/ui Sidebar 与 Header 重叠的问题?
📄 Next.js 开发服务器为何会 JavaScript heap out of memory?