从 v3 迁移

Rollup 3

Vite 现在正式启用 Rollup 3 ，这使得我们可以简化 Vite 内部的资源处理并同时拥有许多改进。详情请查看 Rollup 3 版本记录 。

Rollup 3 尽最大可能兼容了 Rollup 2。如果你在项目中使用了自定义的 rollupOptions 并（升级后）遇到了问题，请先查看 Rollup 迁移指南 来更新升级你的配置。

现代浏览器基准线变化

当前对于现代浏览器的构建目标及现调整为了默认 safari14以求更广的 ES2020 兼容性（从 safari13升级）。这意味着现代化构建现在可以使用 BigInt ，同时 空值合并运算符 将不再被转译。如果你需要支持更旧版本的浏览器，你可以照常添加 @vitejs/plugin-legacy 。

其他一般性变化

编码

构建的默认字符集现在是 utf8（查看 #10753 了解更多细节）。

以字符串形式导入 CSS

在过往的 Vite 3 之中，以默认导入形式导入一个 .css文件的可能会造成对 CSS 的双重加载。

import cssString from './global.css'

这种双重加载出现的原因是 .css文件是将会被释放（emit）到最终产物的，并且很可能 CSS 字符串将会在应用代码中被使用到，就比如被框架运行时注入的时候。对于现在的 Vite 4，.css默认导出 已经被废弃 。在这种情况下你将需要使用 ?inline这个查询参数后缀，而这时将不会将导入的 .css样式文件释放到最终产物。

import stuff from './global.css?inline'

默认情况下的生产构建

不管所传递的 --mode是什么，vite build总是构建生产版本。之前，若将 mode改为 production之外的模式会构建开发版本，如果现在希望用于开发构建，可以在 .env.{mode}文件中设置 NODE_ENV=development。

在本次变动中，如果 process.env.``NODE_ENV已经被定义，vite dev和 vite build将不再覆盖它。所以如果在构建前设置了 process.env.``NODE_ENV = 'development'，将会构建开发版本。这在并行执行多个构建或开发服务器时提供了更多的控制权。

请参阅更新后的 mode 文档 了解更多详细信息。

环境变量

Vite 现在使用 dotenv16 和 dotenv-expand9（之前是 dotenv14 和 dotenv-expand5）如果你有一个包含 #或者 ```的值，你将需要将它们以双引号包裹起来。

-VITE_APP=ab#cd`ef
+VITE_APP="ab#cd`ef"

了解更多详情，请查看 dotenv 和 dotenv-expand 更新日志 。

进阶

下列改动仅会影响到插件/工具的作者：

• [#11036] feat(client)!: remove never implemented hot.decline

• 使用 hot.invalidate来代替

• [#9669] feat: align object interface for transformIndexHtml hook

• 使用 order来代替 enforce

此外，还有其他一些只影响少数用户的破坏性变化。

• [#11101] feat(ssr)!: remove dedupe and mode support for CJS

• 您应该迁移到 SSR 的默认 ESM 模式，CJS SSR 支持可能会在下一个 Vite 主要版本删除。

• [#10475] feat: handle static assets in case-sensitive manner

• 您的项目不应该依赖于会被不同操作系统忽略大小写的文件名。

• [#10996] fix!: make NODE_ENV more predictable

• 有关此更改的解释，请参阅 PR。

• [#10903] refactor(types)!: remove facade type files

从 v2 迁移

请先查看之前 Vite v3 文档中的 Migration from v2 Guide 了解迁移到 v3 所需要的更改，然后再继续执行本页提到的相关更改。