Vite 8.1 插件兼容怎么查：Rolldown 迁移、警告信息与回退边界

项目从 Vite 7 升到 Vite 8.1 后，页面能启动并不代表插件已经兼容。Vite 8 把生产构建和依赖优化统一到 Rolldown，并用 Oxc 接管多项转换工作；旧配置有些会被兼容层自动转换，有些只得到部分支持，还有些已经失效。检查时要把“暂时能跑”与“可以长期保留”分开。

先选迁移路线：直升 8.1 还是经过 rolldown-vite

官方迁移指南给了两种可用路线。依赖少、没有自定义 Rollup 钩子的应用，可以直接把 Vite 7 配置升级为 Vite 8.1 配置。插件链较长的仓库，先使用 rolldown-vite 7.2.2 更容易定位问题：它保留 Vite 7 行为，只把底层构建器换成 Rolldown，再用同一套插件回归用例比较结果。

目标环境中的 Vite 8.1 同时依赖 Rolldown 和 Oxc，因此过渡环境通过并不等于最终升级必然通过。CSS、CJS 互操作、依赖优化和转换插件仍要在 Vite 8.1 上复核。过渡环境只是诊断工具，不应成为长期停留的版本。

从警告里区分自动转换和真正不兼容

Vite 8 仍会把 optimizeDeps.esbuildOptions 自动转换为 optimizeDeps.rolldownOptions，但旧项已经弃用。这里别急着把警告全部静音：普通的 minify、define、loader 等有明确映射，而 esbuildOptions.plugins 只有部分支持。

const inspectRolldownOptions = {
  name: 'inspect-rolldown-options',
  configResolved(config) {
    console.log(config.optimizeDeps.rolldownOptions)
  },
}

先在 configResolved 中查看转换后的结果，再判断插件依赖的字段是否仍存在。若插件调用 transformWithEsbuild，短期需要把 esbuild 单独放进开发依赖；长期应迁到 transformWithOxc。对象形式的 manualChunks 已不再支持，函数形式也已弃用，不能继续当作无害警告。

插件挂在哪一层决定兼容范围

Vite 专用钩子通常放在顶层 plugins，默认同时参与 serve 与 build。Rolldown 插件如果只服务生产构建，可放到 build.rolldownOptions.plugins，它等价于构建阶段的后置插件。两者不是简单的“新旧替换”。

官方给出的兼容边界很明确：依赖 moduleParsed、强耦合打包阶段与输出阶段，或依赖 Rolldown 专属选项的插件，不能假设在 Vite 开发服务器中直接可用。Vite 8.1 的实验性 bundled dev 也只覆盖基本插件和主要能力；第三方插件在该模式失败时，应先关闭实验开关复核普通模式，而不是立即回退整个 Vite 版本。

回退只保留短期兜底

发现插件异常后，优先缩小范围：关闭 bundled dev 实验项、移除单个插件、核对弃用配置，再比较 serve 和 build。确实由 Rolldown 触发时，可暂时回到 Vite 7 基线或保留兼容依赖，但要记录具体插件、配置键和失败阶段。没有这个记录，回退只会把问题推迟到下一次升级。

常见问题

没有警告就说明插件兼容吗？

不一定。还要检查开发、生产构建、SSR 或框架集成实际使用到的钩子，尤其是只在 build 阶段运行的插件。

可以长期保留 transformWithEsbuild 吗？

不建议。它已弃用，单独安装 esbuild 只是迁移兜底；新代码应优先改用 transformWithOxc。