# 从 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 devvite build将不再覆盖它。所以如果在构建前设置了 process.env.``NODE_ENV = 'development',将会构建开发版本。这在并行执行多个构建或开发服务器时提供了更多的控制权。

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

# 环境变量

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

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

了解更多详情,请查看 dotenvdotenv-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 所需要的更改,然后再继续执行本页提到的相关更改。

Last Updated: 6/17/2023, 6:57:19 PM