前端工程化 / 系统课时

从 Vite 7 迁移到 Vite 8

从 Vite 7 迁移到 Vite 8

Vite 8 将构建、依赖优化和 JavaScript 转换切换到 Rolldown 与 Oxc。迁移的关键不是一次改完所有配置,而是先冻结基线,再分离打包器变化与 Vite 8 其他变化,逐步验证开发、构建、测试和部署结果。

学习目标

  • 检查 Node.js、浏览器目标和插件是否满足升级条件
  • 识别需要迁移的 esbuild、Rollup 与插件配置
  • 建立可验证、可定位且可回滚的升级步骤

建立升级基线

Vite 8 与 Vite 7 的 Node.js 要求一致:使用 Node.js 20.19 及以上,或 22.12 及以上。先在独立分支记录运行时、包管理器和当前 Vite 版本,并确保升级前的测试与生产构建通过。

bash
git switch -c chore/vite-8
node --version
npm --version
npm ls vite
npm test
npm run build

预期输出

text
<NODE_VERSION>
<NPM_VERSION>
└── vite@7.x.x
测试通过
构建成功,耗时与产物路径因项目而异

若 Node.js 版本不满足要求,应先升级运行环境与 CI 镜像,不要同时排查运行时和打包器问题。锁文件必须提交到迁移分支,以便准确回滚依赖树。

选择直接或渐进迁移

小型项目可以直接安装 Vite 8。大型项目或自定义插件较多的项目,先在 Vite 7 中把 vite 临时别名到 rolldown-vite,只验证 Rolldown 相关差异;通过后再切回正式的 vite@^8。

Vite 7 到 Vite 8 渐进迁移路径

渐进路径可使用 npm 别名,完成第一阶段后再安装正式版本。

bash
npm install -D vite@npm:rolldown-vite@^7.2
npm run build
npm install -D vite@^8
npm run build

预期输出

text
两次构建均成功;若第一步失败,问题主要集中在 Rolldown 兼容性,若仅第二步失败,再检查 Vite 8 的其他破坏性变化。

审查配置差异

Vite 8 仍提供兼容层,但旧选项已进入迁移期。优先把 optimizeDeps.esbuildOptions 改为 optimizeDeps.rolldownOptions,把顶层 esbuild 转换配置迁到 oxc,并把 build.rollupOptions、worker.rollupOptions 分别迁到 build.rolldownOptions、worker.rolldownOptions。

build.rollupOptions.output.manualChunks 的对象写法不再支持,函数写法也已弃用,应改用 Rolldown 的代码拆分配置。插件若调用 transformWithEsbuild,应迁到 transformWithOxc;暂时无法迁移时,需要显式安装 esbuild,因为 Vite 8 不再直接依赖它。

下面是片段示例,展示常见字段的迁移方向,具体子选项需按原配置逐项核对。

ts
import { defineConfig } from 'vite'

export default defineConfig({
  oxc: {
    jsx: {
      runtime: 'automatic',
    },
  },
  optimizeDeps: {
    rolldownOptions: {
      treeshake: true,
    },
  },
  build: {
    rolldownOptions: {
      output: {
        minify: true,
      },
    },
  },
})

生效行为:JavaScript 转换由 Oxc 配置控制,依赖优化和生产构建的打包选项交给 Rolldown。不要机械复制字段名;例如旧 esbuild 选项并非全部存在一一对应关系。

检查浏览器与模块行为

Vite 8 更新了默认浏览器目标,最低默认范围提升到 Chrome 111、Edge 111、Firefox 114 和 Safari 16.4。项目若仍需更旧浏览器,应显式设置 build.target,并通过真实浏览器或自动化测试验证,而不是依赖旧默认值。

同时重点回归 CommonJS 默认导入、包的 browser、module 与 exports 解析、SSR 外部依赖中的 require 行为,以及压缩后代码。Vite 8 使用 Oxc 压缩 JavaScript、使用 Lightning CSS 压缩 CSS,产物大小或边界语义可能与旧版本不同。

验证插件与部署

逐个检查官方框架插件和第三方 Vite 插件的主版本支持范围。自定义插件要覆盖 resolveId、load、transform、generateBundle 与错误处理路径,尤其避免直接修改 bundle 对象或依赖已移除的 Rollup 钩子。

完整验收至少包含开发启动、热更新、客户端构建、SSR 构建、单元测试、端到端测试和预发布部署。记录每一步的提交,任何阶段失败都回退到最近通过的提交,而不是在同一次改动中继续叠加修复。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

从 Vite 7 迁移到 Vite 8

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通