一、Vite 7 的主要更新内容

1. Node.js 版本要求提高

   • Vite 7 要求最低 Node.js 版本是 20.19+ 或 22.12+。 (vite.dev)

   • 放弃对 Node.js 18 的支持。 (vite.dev)

   • 这样做的原因之一是为了以 ESM-only 分发 Vite，同时仍兼容通过 require 引用 Vite 的 CJS 模块。 (icreatorstudio.com)

2. 默认浏览器目标（build.target）变更

   • 旧版本（Vite 6 及以前）的默认目标是 'modules'。Vite 7 改为了 'baseline-widely-available'。 (vite.dev)

   • 这个 “baseline widely available” 的意思是支持那些 web 平台特性，在主流浏览器里已经比较稳定、并且存在时间较长（至少 30 个月）。 (cn.vite.dev)

   • 对应最低浏览器版本也提高了：例如 Chrome 从 87 → 107, Firefox 78 → 104, Safari 14 → 16 等。 (oschina.net)

3. Rolldown — Rust 驱动的新打包器（试验性／可选）

   • Vite 7 引入了一个 Rust 写的打包器 Rolldown，目前通过 rolldown-vite 包可以作为替代。 (vite.dev)

   • 使用 Rolldown 可以显著加快构建速度，尤其是大项目。 (villpress.com)

   • 但在 Vite 7 默认还是没完全替换 Rollup/Esbuild，这仍然是“可选”方案。 (villpress.com)

4. 压缩 / 最小化工具调整

   • 根据技术栈博客，Vite 7 使用了新的压缩工具：Lightning CSS（CSS 压缩）和 Oxc（JS 压缩）等。 (jishuzhan.net)

   • 这些新工具可能带来更好的性能或更小的构建产物。

5. Environment API 的增强

   • Vite 6 引入了实验性的 Environment API，Vite 7 在此基础上新增了 buildApp 钩子（hook），允许插件更灵活地协调构建不同环境。 (vite.dev)

   • 这个 API 对于构建多环境（比如 SSR、Edge、Runtime provider 等）非常有用。 (villpress.com)

6. Vitest 集成

   • Vite 7 要搭配 Vitest 3.2+ 使用。 (vite.dev)

   • 因为测试环境和构建环境有更好的兼容性。

7. 移除 / 废弃旧 API

   • 移除了 Sass 的 legacy API 支持。 (jishuzhan.net)

   • 移除了 splitVendorChunkPlugin。 (vite.dev)

   • 这些移除对于大多数普通项目可能影响不大，但是如果你之前项目里依赖这些功能，就要特别注意。

8. 调试 & 工具链增强

   • 与 VoidZero 和 NuxtLabs 合作推出 Vite DevTools，可以做更深入调试和分析。 (vite.dev)

   • 插件能力增强（新 hook、配置能力更强）。

二、升级 Vite 6 → Vite 7 时需要注意的事项

根据上面变动，这里是升级时推荐关注或检查的点：

1. 确认 Node 版本

   • 首先要检查你的开发环境 / CI 环境 /部署环境里运行 Vite 的 Node 版本，是否满足 Vite 7 的最低要求（20.19+ 或 22.12+）。

   • 若不满足，需要先升级 Node 或改环境。

2. 浏览器兼容性要求

   • 因为默认 build.target 更改，构建出来的 bundle 针对浏览器最低版本更高。如果你有需要支持更老浏览器的业务（用户群体里有人还用老版本浏览器），可能需要特别设置 build.target，而不是用默认值。

3. 决定是否使用 Rolldown

   • 如果项目比较大、构建时间长，强烈可以考虑试用 rolldown-vite。

   • 但如果目前构建稳定，用默认 Rollup + esbuild 也没问题。切换前建议在本地做性能测试。

   • 插件兼容性：有些 Vite 插件或者 Rollup 插件可能不完全支持 Rolldown（特别是比较老或 edge-case 的插件），升级前要确认。

4. 检查压缩工具带来的差异

   • 新引入的压缩器（Lightning CSS、Oxc）可能和之前 esbuild 压缩行为稍有不同（体积、兼容性、压缩输出等）。建议做构建产物对比（大小、性能、兼容性）以及回归测试。

5. Environment API / 插件 hook 调整

   • 如果你在 Vite 6 已经用了 Environment API，检查你使用的 API 是否和新的 buildApp hook 逻辑冲突或可以优化。

   • 如果你自己写插件、或者使用第三方插件，要看这些插件是否兼容 Vite 7 的新 hook 和 API。

6. Vitest 版本兼容

   • 升级测试相关依赖（Vitest）到 3.2+，以保证测试环境正常运行。

   • 升级后跑所有单元测试 /集成测试，确认没有因为 Vite 升级破坏测试环境。

7. 配置迁移

   • 检查 vite.config.ts/js 中是否使用了已移除或弃用的 API（如 splitVendorChunkPlugin）。

   • 仔细阅读官方提供的迁移指南和 Changelog。 Vite 官方推荐在升级前查看 Migration Guide。 (vite.dev)

   • 如果你有特殊配置（例如自定义构建流程、中间件、自定义插件），要逐项验证。

8. 构建 & 部署验证

   • 升级完之后，一定要完整跑构建（build）、预览（preview）、生产环境部署，并做 smoke test /回归测试。

   • 注意构建时间是否变了（可能更快但也可能有其他边缘问题）。

9. 团队协作 & 文档

   • 如果是团队项目，升级 Vite 是比较大的变动，建议和团队沟通好：什么时候升级、谁负责验证、回退策略。

   • 把升级过程记录下来（如变更 Node 版本、打包器切换、构建产物检查等），以便后续成员理解原因。

三、小结 & 推荐

• 变动很值得升级：Vite 7 带来了性能优化（尤其是 Rolldown）、现代化打包器、更严格 /现代的构建目标，以及更灵活的插件 API，这些都是很有价值的增强。

• 但不是强制立刻全部切换：可以分阶段升级 — 先升级 Vite 本身，保持使用旧打包器；如果稳定，再试 Rolldown。

• 做好测试和验证：升级之后，一定要全面验证构建输出、兼容性、测试流程。

• 关注生态兼容性：部分老插件、脚手架可能还没适配 Vite 7，需要留意。