构建工具:Vite 8 与 Rolldown 工程配置
本篇要点:能读懂一次
vite build的时间分别花在哪些阶段,并按两段式路径把一个 Vue 3 项目迁到 Vite 8 + Rolldown。 前置文章:《TypeScript 与 Vue:类型安全与类型测试》讲的是类型检查如何守住组件契约,这一章往下走一层,看这些 TypeScript 代码最终怎样被转译、分包和压缩。
为什么需要它
2026 年 8 月,一个 47 万行的 monorepo 要做构建提速。仓库里 12 个 Vue 应用共用同一套插件,单个应用的 vite.config.ts 挂了 23 个插件。CI 上一次完整构建 6 分 40 秒,改一行样式要等 40 秒才能在预览环境看到,合并请求排到晚上。
Vite 8 的公告给了很诱人的数字:Rolldown 打包比 Rollup 快 10–30 倍,早期采用者自报 Linear 从 46 秒到 6 秒、Beehiiv 降 64%、Ramp 降 57%、Mercedes-Benz.io 最高 38%。这些数据都出自 rolldown-vite 预览期的内测。
团队按这个比例估算,6 分 40 秒应该落到 40 秒左右。实际是 2 分 18 秒,省了 66%,离十倍差一个数量级。
差的那部分不是 Rolldown 没做到,是分母选错了。构建时间里有一大块根本不由打包器决定:PostCSS 处理、i18n 文案扫描、SVG 图标生成、插件钩子里的文件读写。这些在换打包器之后一秒都不会变快。这一章先教怎么把时间拆开看,再决定升不升。
版本先对齐,避免照着旧文章配错:Vite 8.0 在 2026 年 3 月 12 日 GA,截至 2026 年 11 月 8.x 最新是 8.3.8(2026-11-11 发布),依赖 rolldown@~1.2.18,Node 要求与 Vite 7 一致:^20.19.0 || >=22.12.0。
核心概念
打包器(bundler):并行扫的不是全部
打包器把上百个模块按依赖图合并成少量产物文件,过程中做 tree shaking(摇树,删掉没被引用的导出)、代码分割、产物命名。Vite 7 的生产构建用 Rollup,Vite 8 换成 Rolldown——Rollup 的 Rust 重写,把原来单线程的模块遍历摊到多核。
打个比方:Rollup 像一个收银员逐件扫码,Rolldown 是开八个收银台同时扫,但每辆推车里的商品数量没变。
反例是以为换了打包器,整个 build 就按比例变快。打包只是流水线的一段,前面有转译,后面有压缩,两边还挂着插件。
统一工具链:两套管线并成一套
Vite 7 内部是两条管线:开发期用 esbuild 转译 TS/JSX,生产期用 Rollup 打包,两者的行为差异靠 Vite 的胶水层抹平。Vite 8 里 Oxc 既转译又压缩,Rolldown 既做开发期依赖预构建又做生产打包,一条路走到底,如图 3-1 所示。
图 3-1 两代构建管线的差别,关键在于转译节点所处的位置
图里真正要紧的是转译节点在管线上的位置。Vite 7 有两套降级规则,dev 下能跑的语法在 build 下可能被另一套规则处理;Vite 8 只有一套,好处是 dev 与 build 的降级结果终于一致,坏处是过去针对 esbuild 写的插件补丁全部失效,而且任何一处转译出错都没有第二条路径兜底。
反例是升级后只跑 pnpm dev 就宣布通过。dev 和 build 虽然同管线,但入口、插件触发条件和产物目标都不同,两边各跑一遍关键页面这个动作不能省。
阶段归因:先量再改
阶段归因指用 vite build --debug 把总耗时拆成依赖预构建、转译、打包分包、插件钩子、压缩、冷缓存解析几段,每段单独计时。修水管之前得先摸清哪一段在漏,不是把整根管子换掉。
反例是拿总耗时去对标厂商公布的打包耗时。两个分母不同,比出来的结论必然失真。一个 47 万行仓库升级前后的实测:
| 阶段 | Vite 7.3 | Vite 8.3.8 | 变化 |
|---|---|---|---|
| 依赖预构建 + TS 转译 | 约 52s | 约 31s | Oxc 接手,与压缩走同一套 |
| 打包与分包 | 约 5 分 10s | 约 1 分 05s | Rolldown 原生并行,这一段是主力 |
| PostCSS / i18n 扫描 / SVG 插件 | 约 38s | 约 38s | 一点没变 |
| 产物压缩 | 约 30s | 约 12s | Oxc minifier |
| 冷缓存解析 | 约 40s | 约 42s | 略涨 |
最后两行最容易被忽略:插件阶段的 38 秒完全没变,冷缓存解析甚至从 40 秒涨到 42 秒。Rolldown 的模块级持久缓存只对增量构建有效,首次构建仍然要全量解析每个模块。
由此得出判断规则:如果构建时间里插件与后处理占了一半以上,升级能拿到的收益就只剩另一半的比例;如果生产构建本来就在 10 秒以内,绝对收益只有几百毫秒,评估、回归、回滚演练的成本比省下的时间贵。
兼容层的有损翻译
Vite 8 会把老配置里的 esbuild、rollupOptions 自动翻译成 oxc、rolldownOptions,但翻译不是一一对应,没有对应项的字段会被静默丢弃。这像把一份方言合同翻成普通话,翻不出的条款直接跳过,也没人告诉你少了哪几条。
反例:esbuild.supported 在 Oxc 里没有对应项,esbuild.banner、esbuild.footer 直接不支持。老配置写了等于没写,构建不报错,产物里就是没有那行 banner。
动手实践
第一步:把两个变量拆开
官方推荐两段式:先在 Vite 7 上把打包器换成 rolldown-vite,跑通之后再升 8.x。一步到位的话,第一次构建失败时你分不清是打包器的锅还是大版本的锅。
# 前提:仓库已能正常 pnpm build,Node 20.19+ 或 22.12+
# 第一步:Vite 7 + Rolldown,只换打包器,其余不动
pnpm add -D vite@npm:rolldown-vite@7.3.1
pnpm build && pnpm dev
# 第二步:确认无回归后切回官方包并升 8.x
pnpm add -D vite@^8.3.8
pnpm build运行结果:第一步结束后 pnpm why vite 显示 vite 7.3.1 被 rolldown-vite 覆盖,构建与 dev 均正常,插件告警逐条记进清单;第二步后版本变为 8.3.8,pnpm build 退出码 0。如果第二步失败,先跑 pnpm vite build --debug 看解析后的配置,别对着文档猜。
第二步:把翻译后的真实配置打出来
// vite.config.ts —— 迁移期临时插件,只在本地排查时启用
// 前提:vite@8.3.8
import { defineConfig, type Plugin } from 'vite'
const dumpResolvedConfig: Plugin = {
name: 'dump-resolved-config',
configResolved(config) {
// 兼容层翻译后的真实结果都在这两个字段里
console.log('[oxc]', JSON.stringify(config.oxc, null, 2))
console.log('[rolldown]', JSON.stringify(config.build.rolldownOptions, null, 2))
},
}
export default defineConfig({
plugins: [dumpResolvedConfig],
})预期输出:终端打印两段 JSON。[oxc] 里找不到 supported、banner、footer 的痕迹;[rolldown] 的 output 只有函数形式的 codeSplitting,没有对象形式的 manualChunks——对象写法在 8.x 已移除,得改成函数或 build.rolldownOptions.output.codeSplitting。
第三步:给自研插件补 moduleType
.txt、.md 这类虚拟模块被当成 JS 解析,是升级后最常见的报错之一。根因是 Rolldown 按扩展名推断 module type,而 load 的返回值没告诉它这是 JS。
// 自研插件改造:返回非 JS 内容时必须声明 moduleType
// 前提:vite@8.x,load 钩子支持 filter 对象形式
import fs from 'node:fs'
import type { Plugin } from 'vite'
export function txtLoader(): Plugin {
return {
name: 'txt-loader',
load: {
filter: { id: /\.txt$/ },
handler(id) {
return {
code: `export default ${JSON.stringify(fs.readFileSync(id, 'utf-8'))}`,
moduleType: 'js', // 少了这行,按 .txt 推断类型后报错
}
},
},
}
}运行结果:补上 moduleType 之前,构建抛 BundleError,日志只有一行 Build failed,真实原因藏在 error.errors 数组里;补上之后构建通过,import txt from './note.txt' 拿到字符串。顺带一个 CI 习惯:把 error.errors 序列化成 JSON 存进 artifacts,比在本地复现快得多。
还有一类问题不报错:CJS 包的 import x from 'pkg' 从对象变成 undefined。default 导入语义统一之后,不再看 __esModule 之外的那些启发式判断,而这个问题只在运行时显现。排查办法是升级前后各打一份产物,diff 一下 node_modules 里那几个 CJS 包相关的 chunk。legacy.inconsistentCjsInterop 能让它先跑起来,但那只是止血带——留着它,等于把"官方哪天删掉这个开关"变成一颗定时炸弹。
第四步:两个值得立刻开的配置
// vite.config.ts
// 前提:vite@8.3.8,tsconfig.json 里已配好 paths
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
export default defineConfig({
plugins: [vue()],
resolve: {
// 内置 tsconfig paths 解析,可以删掉 vite-tsconfig-paths
tsconfigPaths: true,
},
server: {
// 浏览器 console 转发到终端
forwardConsole: { unhandledErrors: true, logLevels: ['error', 'warn'] },
},
})预期输出:删掉 vite-tsconfig-paths 后 import Foo from '@/components/Foo.vue' 仍然解析成功;浏览器里抛一个未捕获的 Promise 错误,终端同步打印同样的堆栈。
tsconfigPaths 官方注明有轻微性能开销,所以默认关闭;它只读 paths,像 @/ 同时映射多个目录这种写法还得靠 resolve.alias 兜底。forwardConsole 解决的是"只在浏览器里报错、CI 日志里什么都没有",代价是终端会变吵。
同批新增的 Devtools 建议先别开。它能显示依赖图、模块转换耗时、插件执行时间,回答"这 200 毫秒是谁贡献的"很准;但装上之后 dev server 启动多几百毫秒(@vitejs/devtools 截至 2026 年 11 月最新 0.8.3,还要额外安装,没装则选项静默不生效)。把它放进个人 dev 脚本或本地 .env,不要让全组为一个人的排查需求付启动时间。
第五步:回滚路径写进方案
关键是不要把升级和生产发布绑在同一次变更里。vite 的版本改动单独一个 PR,合并后先在 CI 跑通,观察一周构建稳定性,最后才随业务发布。
回滚分支保留 vite@^7.3 加 @vitejs/plugin-vue@^6:7.x 仍在维护(7.3.8 发布于 2026-11-09),plugin-vue 6.x 的 peer 同时覆盖 7 和 8,两条线可以共用一套插件配置。
回滚最容易翻车的地方是缓存键。CI 的缓存键里如果不带 Vite 主版本号,回退到 vite@^7.3 之后拿到的是 Vite 8 生成的缓存,报错信息毫无指向性。这个坑花四十分钟很常见,改一行缓存 key 就能避开。
升级前还有几件事值得花半小时确认:pnpm why vite 全仓库只有一个版本,没有子包锁在 7.x;build.target 的默认值变了(Chrome 111 / Safari 16.4),确认目标用户覆盖率还达标;依赖 build.rollupOptions.watch.chokidar 的地方换成 rolldownOptions.watch.watcher;用 lightningcss 压缩的项目,CSS 体积可能小幅上涨,属预期。
常见误解
其一,以为官方说快 10–30 倍,总构建时间就会按这个比例缩。其实是打包那一段快了四五倍,其余阶段原地不动,总时间只按打包占比打折。47 万行仓库从 6 分 40 秒到 2 分 18 秒就是这个折算结果,插件占大头的项目收益更小。
其二,以为"官方承诺完整插件兼容"等于行为一致。兼容只保证插件能跑起来,不保证配置项都被翻译。凡是有损的地方都不会报错,只会让产物少点东西。
其三,以为 CI 上的时间就是本地的时间。CI 每次全新 clone 加全新 node_modules,冷缓存那一段比本地贵,同一个仓库本地 2 分 18 秒、CI 上 3 分 40 秒是常态。立项时写清楚这一点,比上线后被问"为什么没快到十倍"省事。
小结
《TypeScript 与 Vue:类型安全与类型测试》守住的是类型,这一章落到产物。五条要点可以直接当复习清单:
- Vite 8 把 esbuild + Rollup 的两套管线并成 Oxc + Rolldown 一套,同一条规则管 dev 和 build,代价是旧插件补丁失效且没有备用路径。
- 该不该升的依据是构建时间里打包占多少,不是官方倍数。生产构建 10 秒以内的项目,绝对收益撑不起评估成本。
- 两段式升级(先
rolldown-vite,再 Vite 8)把"打包器问题"和"大版本问题"分开,排查成本差一个数量级。 - 兼容层是有损翻译:
esbuild.supported、banner、footer静默失效,对象形式的manualChunks被移除,moduleType不写就报BundleError。 - 回滚的缓存键必须带 Vite 主版本号,否则缓存和代码版本不匹配,报错毫无指向性。
相关主题
构建能跑之后,下一个问题是首屏要等多久,而首屏慢有一大半慢在请求串行上。《路由:Vue Router 4 与数据加载》看 Vue Router 的路由级数据加载(data loader),把这个瀑布流拆成一次并行提交。