Vite 5.0 正式发布

11 月 16 日，Vite 5.0 正式发布，这是 Vite 道路上的又一个重要里程碑！Vite 现在使用 Rollup 4，这已经代表了构建性能的大幅提升。此外，还有一些新的选项可以改善开发服务器性能。

Vite 4 发布于近一年前，它为生态系统奠定了坚实的基础。随着项目继续在共享基础设施上构建，每周 npm 下载量从 250 万跃升至 750 万。框架不断创新，除了 Astro、Nuxt、SvelteKit、Solid Start、Qwik City 等，还看到新的框架加入并使生态系统更加强大。RedwoodJS 和 Remix 转向 Vite 为 React 生态系统的进一步采用铺平了道路。Vitest 的增长速度甚至超过了 Vite。其团队一直在努力，很快将发布 Vitest 1.0。Vite 与 Storybook、Nx 和 Playwright 等其他工具一起使用的故事不断改进，环境也是如此，Vite 在 Deno 和 Bun 中都是可以使用的。

六个月前，Vite 4.3 版本发布。该版本显著提高了开发服务器的性能。然而，仍有很大的改进空间。在 ViteConf 上，尤雨溪公布了 Vite 的长期计划，即致力于开发 Rolldown，这是一个带有兼容 API 的 Rust 移植版的 Rollup。一旦准备就绪，打算在 Vite Core 中使用它来承担 Rollup 和 esbuild 的任务。这将意味着提高构建性能，并大大减少开发和构建之间的不一致。 Rolldown 目前处于早期阶段，团队正准备在年底前开源代码库。敬请关注！

Vite 5 专注于清理 API（删除不推荐使用的功能），并简化了解决长期问题的几个功能，例如切换定义以使用正确的 AST 替换而不是 regex。团队还将继续采取措施来实现未来的 Vite（Node.js 18+ 现在是必需的，CJS Node API 已被弃用）。

快速开始使用 Vite 5

可以使用 pnpm create vite 用喜欢的框架搭建 Vite 项目，或者使用 vite.new 在线打开启动模板来使用 Vite 5。还可以运行 pnpm create vite-extra 来访问其他框架和运行时（Solid、Deno、SSR 和库启动器）的模板。当在“其他”选项下运行 create vite 时，也可以使用 create vite-extra 模板。

注意，Vite 入门模板旨在用作使用不同框架测试 Vite 的平台。在构建下一个项目时，建议使用每个框架推荐的启动器。一些框架现在也将 create vite 重定向到它们的启动器（Vue 的 create-vue 和 Nuxt 3，以及 Svelte 的 SvelteKit）。

Node.js 支持

Vite 不再支持已 EOL 的 Node.js 14 / 16 / 17 / 19。现在需要 Node.js 18 / 20+。

性能

除了 Rollup 4 的构建性能改进之外，还有一个新指南可帮助你识别和修复常见性能问题：vitejs.dev/guide/perfo…

Vite 5 还引入了 server.warmup，这是一项改善启动时间的新功能。它允许定义应在服务器启动后立即进行预转换的模块列表。当使用 --open 或 server.open 时，Vite 还会自动预热应用的入口点或提供的 URL 以打开。

主要更新

Vite 现在由 Rollup 4 提供支持

Vite 现在使用 Rollup 4，它也带来了重大变化，包括：

• Import assertions 已更名为 import attributes。
• 不再支持 Acorn 插件。
• 对于 Vite 插件，this.resolve的skipSelf选项现在默认为true。
• 对于 Vite 插件，this.parse目前仅支持allowReturnOutsideFunction选项。

CJS Node API 已被弃用

Vite的CJS Node API 已被弃用。当调用require('vite')时，现在会记录弃用警告。应该更新文件或框架，以导入Vite的ESM构建而不是CJS构建。

在基本的Vite项目中，请确保：

• vite.config.js文件内容使用ESM语法。
• 最接近的package.json文件包含"type": "module"，或者使用.mjs扩展名，例如vite.config.mjs。

对于其他项目，有一些常见的方法：

• 将 ESM 配置为默认选项，根据需要选择 CJS：在项目的package.json中添加"type": "module"。所有*.js文件现在都被解释为ESM，并且需要使用 ESM 语法。可以将带有.cjs扩展名的文件重命名，以继续使用 CJS。
• 将 CJS 配置为默认选项，根据需要选择ESM：如果项目的package.json没有"type": "module"，所有*.js文件都将被解释为 CJS。可以将带有.mjs扩展名的文件重命名，以使用 ESM。
• 动态导入 Vite：如果需要继续使用 CJS，可以使用import('vite')进行动态导入 Vite。这需要代码以异步上下文编写，但由于 Vite 的 API 大多是异步的，因此应该仍然可以管理。

重新制定 define 和 import.meta.env.* 的替代策略

在 Vite 4 中，define和import.meta.env.*功能在开发和构建中使用不同的替换策略：

• 在开发环境中，这两个功能被注入为全局变量到globalThis和import.meta中。
• 在构建环境中，这两个功能被静态地使用正则表达式替换。

这导致在尝试访问这些变量时出现开发环境和构建环境的不一致性，有时甚至会导致构建失败。例如：

// vite.config.js
export default defineConfig({
  define: {
    __APP_VERSION__: JSON.stringify('1.0.0'),
  },
})

const data = { __APP_VERSION__ }
// dev: { __APP_VERSION__: "1.0.0" } ✅
// build: { "1.0.0" } ❌
const docs = 'I like import.meta.env.MODE'
// dev: "I like import.meta.env.MODE" ✅
// build: "I like "production"" ❌

Vite 5 通过使用 esbuild 来处理构建中的替换，与开发行为保持一致。

这个改变不应该影响大多数设置，因为已经有文档说明define的值应该遵循 esbuild 的语法：

为了与 esbuild 的行为保持一致，表达式必须是一个 JSON 对象（null、boolean、number、string、array或object）或者一个单个的标识符。

然而，如果你更喜欢直接保持静态替换值，可以使用 @rollup/plugin-replace。

worker.plugins 现在是一个函数

在 Vite 4 中，worker.plugins接受一个插件数组((Plugin | Plugin[])[])。而在 Vite 5 中，它需要配置为一个返回插件数组的函数(() => (Plugin | Plugin[])[])。这个改变是为了使并行的工作器构建更加一致和可预测。

允许包含 . 的路径回退到 index.html

在 Vite 4 中，在开发环境中访问包含点"."的路径时，即使将appType设置为'spa'（默认值），也不会回退到index.html。而在 Vite 5 中，它将会回退到index.html。

注意，如果将图像路径指向一个不存在的文件（例如<img src="./file-does-not-exist.png">），浏览器将不再在控制台中显示 404 错误消息。

统一开发和预览 HTML 服务行为

在 Vite 4 中，开发服务器和预览服务器根据目录结构和末尾斜杠来不同地提供HTML服务。这会导致在测试构建后的应用时出现不一致性。Vite 5 将重构成以下类似的单一行为，假设以下文件结构：

├── index.html
├── file.html
└── dir
    └── index.html

manifest 文件会在 .vite 目录中生成

默认情况下，Vite 4 中的清单文件（build.manifest和build.ssrManifest）是在构建的根目录中生成的。

而从 Vite 5 开始，默认情况下它们将会生成在.build.outDir目录中的.vite目录中。这个改变有助于避免公共文件与相同的清单文件名在复制到build.outDir时发生冲突。

CLI 快捷方式需要额外的 Enter 键触发

现在，CLI的快捷方式（例如r键重启开发服务器）需要额外按下Enter键才能触发快捷方式。例如，按下r键后再按Enter键来重启开发服务器。

这个改变防止 Vite 吞噬和控制特定于操作系统的快捷方式，使得将 Vite 开发服务器与其他进程结合使用时更加兼容。

更新experimentalDecorators和useDefineForClassFields在 TypeScript 中的行为

Vite 5 使用 esbuild 0.19，并移除了对 esbuild 0.18 的兼容层，这改变了 experimentalDecorators 和 useDefineForClassFields 的处理方式。

• **experimentalDecorators**默认情况下是未启用的，需要在tsconfig.json中将compilerOptions.experimentalDecorators设置为true才能使用装饰器。
• **useDefineForClassFields**的默认值取决于TypeScript的目标值，如果目标不是ESNext或ES2022或更新版本，或者没有tsconfig.json文件，则useDefineForClassFields将默认为false，这可能会导致问题，因为默认的esbuild.target值是esnext。它可能会转译为静态初始化块，而这在浏览器中可能不被支持。

因此，建议在配置tsconfig.json时将目标设置为ESNext或ES2022或更新版本，或者显式将useDefineForClassFields设置为true。

{
  "compilerOptions": {
    // 如果使用装饰器，设置为true
    "experimentalDecorators": true,
    // 如果在浏览器中看到解析错误，设置为true
    "useDefineForClassFields": true
  }
}

移除--https标志和https: true

-https标志在内部设置了server.https: true和preview.https: true。这个配置原本是用来与 Vite 3 中取消的自动 https 证书生成功能一起使用的。因此，这个配置不再有用，因为它会启动一个没有证书的 Vite HTTPS 服务器。

如果使用的是@vitejs/plugin-basic-ssl或vite-plugin-mkcert，它们已经在内部设置了 https 配置，所以可以在设置中移除--https、server.https: true和preview.https: true。

移除resolvePackageEntry和resolvePackageData API

resolvePackageEntry和resolvePackageData API已被移除，因为它们暴露了 Vite 的内部结构，并阻碍了过去 Vite 4.3 的潜在优化。可以使用第三方包替代这些API，例如：

• resolvePackageEntry: 使用 import.meta.resolve 或 import-meta-resolve包。
• resolvePackageData: 同上，并向上遍历包目录以获取根package.json。或者使用社区的 vitefu 包。

import { resolve } from 'import-meta-env'
import { findDepPkgJsonPath } from 'vitefu'
import fs from 'node:fs'
const pkg = 'my-lib'
const basedir = process.cwd()
// `resolvePackageEntry`:
const packageEntry = resolve(pkg, basedir)
// `resolvePackageData`:
const packageJsonPath = findDepPkgJsonPath(pkg, basedir)
const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'))

已移除的过时 API

• CSS 文件的默认导出（例如 import style from './foo.css'）：改用?inline查询参数代替
• import.meta.globEager：改用 import.meta.glob('*', { eager: true }) 代替 ssr.format：'cjs' 和 legacy.buildSsrCjsExternalHeuristics
• server.middlewareMode：'ssr' 和 server.middlewareMode：'html'：改用 appType + server.middlewareMode: true 代替。