Vite 8.4.0-beta.1:optimizeDeps.rollupOptions 被移除、css.devSourcemap 改名、fs.strict 多出一档 extended
参考:Vite CHANGELOG、Announcing Vite 8
当前稳定版是 8.3.8(2026-11-11),8.4.0-beta.1 发布于 2026-11-16。beta 里这几处改动不会让构建立刻报错,但会让旧配置不再生效——配置项还写着,行为已经没有。下面按「需要改你配置」的顺序列一遍,再补 8.3.x 里值得关注的修复和 Vite 8 的 rolldown 前提。
一、optimizeDeps.rollupOptions 被移除
Refactor #23760 删掉了这个键。
Vite 8 用 Rolldown 作为单一打包器,兼容层会把已有的 esbuild 与 rollupOptions 配置自动转成 Rolldown/Oxc 的等价物,但 optimizeDeps.rollupOptions 这个入口本身已经不存在,原先写在里面透传给 rollup 的预构建选项没有对应配置项。依赖预构建需要干预时走 optimizeDeps 现有的 include/exclude/entries,其余改用 Rolldown 侧的配置。升级前建议 grep 一遍,避免配置被静默忽略。
二、css.devSourcemap 迁移为 dev.sourcemap.css
#23765。旧键 css.devSourcemap 不再生效,新位置是 dev.sourcemap.css。
这类改名真正需要警惕的地方在于它既不报错也不警告:配置留在那里,只是 CSS 的 sourcemap 不再产出,直到某天在 DevTools 里发现样式对不上行号。手上有自定义 css 配置的项目,直接搜 devSourcemap。
三、--configLoader 转为稳定,runner 弃用
#23714:--configLoader 从实验性转为稳定,同时 --configLoader=runner 被标记弃用。CI 脚本或 npm scripts 里写死 runner 的,现在就该换掉,不要等到移除的那一版。
四、新增 server.fs.strict: 'extended'
#23972 增加了一个更严格的取值。默认的 strict 已经是白名单式访问,'extended' 在它之上再紧一档,面向 workspace、pnpm 这类 node_modules 通过符号链接外挂的目录结构,用来收紧文件系统访问面。
开启后原本能读到的路径可能被拒掉,需要把项目实际用到的目录显式加进 server.fs.allow。这是需要主动开启的选项,不是升级默认变化,但如果你正被 monorepo 里越界的文件访问困扰,它提供了一个介于 strict 和完全放开之间的具体档位。
五、8.3.x 里值得关注的修复
8.3.8 和 8.3.6 是一串 bug fix,其中几条会影响构建结果:
build.cssCodeSplit: false时拒绝 CSS 入口(#23112)。以前把 CSS 当入口又关掉 code split,产出是不完整的;现在直接报错。如果有项目这么配过,升级到 8.3.8 会先暴露出来。- bundled-dev 下按
base加载懒加载 chunk(#23798)。部署在子路径的项目,懒加载 chunk 的请求路径终于带对了base。 es-module-lexer升级到 v3(#23603)。- 另外两条边界收紧:wasm 拒绝
server.fs之外的.wasm(#23914);会监听new URL(..., import.meta.url)引用的文件(#23780)。
8.3.0 则加了顶层 tsconfig 选项(#23310),以及 CSS style tag 压缩等改动。
六、Vite 8 的前提:Node 版本与安装体积
Vite 8 以 Rolldown 作为单一、统一的 Rust 打包器,官方给出的数字是 10–30x 构建速度,插件保持兼容。运行时要求 Node.js 20.19+ / 22.12+(与 Vite 7 一致),仅以 ESM 分发。
安装体积比 Vite 7 大约多 15MB:其中 lightningcss 从可选依赖变成常规依赖约 10MB,Rolldown 二进制约 5MB。
官方建议的迁移路径是分两步:先在 Vite 7 上把 vite 换成 rolldown-vite 包,把 Rolldown 相关的问题隔离出来处理掉,再升级到 Vite 8。这样出问题时能判断是打包器换血导致的,还是 8.x 自身的变更导致的。
升级检查清单
# 1. 已移除的预构建选项
grep -rn "optimizeDeps" --include="*.ts" --include="*.js" --include="*.mjs" . \
| grep rollupOptions
# 2. 改名前的 CSS sourcemap 键
grep -rn "devSourcemap" .
# 3. 弃用的 configLoader
grep -rn "configLoader" . --include="*.json" --include="*.yml" --include="*.sh" --include="*.js"
# 4. 现有 fs 配置,评估是否上 extended
grep -rn "fs.strict\|fs.allow" vite.config.*
对应动作:
optimizeDeps.rollupOptions里的内容按语义拆到optimizeDeps或 Rolldown 配置;css.devSourcemap改成dev.sourcemap.css;--configLoader=runner换成稳定写法;- Node 版本确认在 20.19+ / 22.12+,CI 镜像一并检查;
- monorepo / pnpm 项目评估是否启用
server.fs.strict: 'extended',启用前先备好server.fs.allow列表; - 先在 Vite 7 上换
rolldown-vite跑通构建,再升 Vite 8。