New Hot

Vite 8.3.8 发布:修复内联 worker 资源与 CSS 拆包报错,提升 sass 导入性能

Vite构建工具前端版本更新

Vite 8.3.8 发布,修复内联 worker 在加载阶段未输出所引用资源、关闭 cssCodeSplit 时仍接受 CSS 入口、Windows 上 yarn config get 弹出控制台窗口等问题,并让 sass 只导入一次以改善构建性能。使用 Vite 8 的前端项目建议跟进。

Vite 8.3.8 修复内联 worker 资源缺失与 CSS 入口校验

Vite 8.3.8 是一次补丁发布,重点是修复内联 worker 的资源输出、CSS 入口校验与 Windows 环境下的配置读取问题。

内联 worker 的资源补齐

修复了 bundled 开发模式下,内联 worker 在加载阶段没有输出其引用资源的问题。此前这类资源可能在生产产物里缺失,导致 worker 运行时拿不到依赖文件。(来源:Vite 官方发布说明)

CSS 拆分与配置校验

当 build.cssCodeSplit: false 时,构建现在会拒绝 CSS 入口,避免产出与配置预期不一致的结果。官方原文称:“css: reject CSS entrypoints when build.cssCodeSplit: false”。配置侧还跳过仅类型导入的原生 loader 兼容检查,减少误报。

性能与依赖维护

CSS 处理改为只导入一次 sass,而不是每个文件各导入一次;Windows 上把 net use 延后到 UNC 路径解析完成之后执行。Windows 下运行 yarn config get 时弹出控制台窗口的问题也被修复,同时把 @types/node 更新到 v26。

内联 worker 产物补全,sass 只解析一次

使用内联 worker、关闭 CSS 拆包或依赖 sass 的大型前端项目,能从这次修复中直接受益。

构建产物更完整

内联 worker 引用的资源不再丢失,说明这类项目的生产构建结果更接近开发态。用 worker 处理图片、字体或 WASM 的项目,建议重新构建并检查产物目录。

CSS 配置更严格

关闭 CSS 拆包后传 CSS 入口会被拒绝,说明构建会提前暴露配置矛盾。从官方描述看,这是把隐式错误变成显式报错,迁移时要调整入口配置。

构建速度小幅改善

sass 只导入一次能减少重复解析,项目越大收益越明显。与 webpack 5.112.2 的模块拼接优化 类似,这类改动通常不改变产物语义。打包器的另一条路线可以参考 esbuild 0.28.2 修复说明。

使用内联 worker 或关闭 CSS 拆包的项目应升级

遇到内联 worker 资源缺失、CSS 拆包报错或 Windows 配置读取异常的项目,建议直接升级。

谁适合现在升级

使用 ?worker&inline 内联 worker、设置 cssCodeSplit: false、或在 Windows 上做本地构建的团队,收益最直接。只做常规 SPA 构建的项目风险很低。

怎么升级

把 vite 依赖升到 8.3.8 即可,本次是补丁版本,没有列出破坏性变更。升级后重新执行一次生产构建,确认 worker 相关产物与 CSS 输出正常。

需要注意的地方

发布说明里的 transform 钩子元信息修复随后被回退,说明该改动仍在调整中。官方未披露回退步骤,遇到问题可以回到上一个 8.3.x 补丁版本。

常见问题

Vite 8.3.8 修复了哪些构建问题?
主要修复内联 worker 资源未输出、CSS 入口校验缺失、transform 钩子元信息保留等问题。
Vite 8.3.8 对 CSS 拆分配置有什么影响?
关闭 build.cssCodeSplit 后,CSS 入口现在会被拒绝,避免生成不符合预期的产物。
Vite 8.3.8 的性能改进体现在哪?
sass 改为只导入一次而不是每个文件各导入一次,Windows 上的 UNC 路径也延后处理。
Vite 8.3.8 需要马上升级吗?
遇到内联 worker 资源缺失或 CSS 拆包报错的项目建议升级,普通项目可随补丁版本跟进。

相关术语

Vite
Vite 是前端构建与开发服务器工具,用原生 ESM 提供快速冷启动和热更新。
worker
worker 是浏览器里与主线程并行的脚本执行环境,常用于拆分计算密集任务。
sass
sass 是 CSS 预处理器,提供变量、嵌套与模块化导入等能力。
cssCodeSplit
cssCodeSplit 是 Vite 的构建选项,决定 CSS 是否按异步 chunk 拆分输出。

这篇文章的来源是什么?

文中涉及版本、价格与功能的信息,均以厂商原文为准;下面是可以核对的原始出处。

「Vite 8.3.8」 —— Vite

搜索文章

输入关键词,快速查找标题和正文内容。