diff --git a/changes/index.md b/changes/index.md index b5392af7..e6193514 100644 --- a/changes/index.md +++ b/changes/index.md @@ -6,7 +6,9 @@ Vite 中的破坏性变更列表,包括 API 废弃、移除和变更。在你 这些变更计划在 Vite 的下一个主要版本中进行。我们会通过废弃或使用警告来尽可能地引导你,同时我们也正在联系框架、插件的作者以及用户来实施这些变更。 -- _目前还没有计划中的变更_ +- [钩子函数中的 `this.environment`](/changes/this-environment-in-hooks) +- [HMR `hotUpdate` 插件钩子](/changes/hotupdate-hook) +- [使用 `ModuleRunner` API 进行服务端渲染](/changes/ssr-using-modulerunner) ## 考虑中 {#considering} @@ -14,10 +16,7 @@ Vite 中的破坏性变更列表,包括 API 废弃、移除和变更。在你 我们目前还不建议你切换到这些 API。我们将它们包含在 Vite 中是为了帮助我们收集反馈。请查看这些提案,并在每个提案相关联的 GitHub Discussions 中告诉我们它们在你的使用场景中的表现如何。 -- [钩子函数中的 `this.environment`](/changes/this-environment-in-hooks) -- [HMR `hotUpdate` 插件钩子](/changes/hotupdate-hook) - [迁移到基于环境的API](/changes/per-environment-apis) -- [使用 `ModuleRunner` API 进行服务端渲染](/changes/ssr-using-modulerunner) - [构建过程中的共享插件](/changes/shared-plugins-during-build) ## 历史 {#past} diff --git a/guide/api-environment-frameworks.md b/guide/api-environment-frameworks.md index 4765d250..ccfac4f1 100644 --- a/guide/api-environment-frameworks.md +++ b/guide/api-environment-frameworks.md @@ -1,7 +1,9 @@ # 用于框架的环境 API {#environment-api-for-frameworks} -:::warning 实验性 -环境 API 仍处于实验阶段。我们仍将在主要版本之间保持 API 的稳定性,以便生态系统进行实验和构建。我们计划在下游项目有时间试验并验证新功能后,在未来的主要版本中稳定这些新 API(可能包含重大更改)。 +:::info 发布候选版本 +环境 API 目前处于发布候选阶段。我们将在主要版本发布之间保持 API 的稳定性,以便生态系统能够进行实验并在此基础上进行开发。然而,请注意,[某些特定的 API](/changes/#considering) 仍被视为实验性 API。 + +我们计划在未来主要版本发布时,待下游项目有足够时间对新功能进行实验并验证后,对这些新 API(可能包含兼容性变更)进行稳定化处理。 资料: diff --git a/guide/api-environment-instances.md b/guide/api-environment-instances.md index d755dc27..4f210bf0 100644 --- a/guide/api-environment-instances.md +++ b/guide/api-environment-instances.md @@ -1,7 +1,9 @@ # 使用 `Environment` 实例 {#using-environment-instances} -:::warning 实验性 -环境 API 仍处于实验阶段。我们仍将在主要版本之间保持 API 的稳定性,以便生态系统进行实验和构建。我们计划在下游项目有时间试验并验证新功能后,在未来的主要版本中稳定这些新 API(可能包含重大更改)。 +:::info 发布候选版本 +环境 API 目前处于发布候选阶段。我们将在主要版本发布之间保持 API 的稳定性,以便生态系统能够进行实验并在此基础上进行开发。然而,请注意,[某些特定的 API](/changes/#considering) 仍被视为实验性 API。 + +我们计划在未来主要版本发布时,待下游项目有足够时间对新功能进行实验并验证后,对这些新 API(可能包含兼容性变更)进行稳定化处理。 资料: diff --git a/guide/api-environment-plugins.md b/guide/api-environment-plugins.md index dd67b55e..4a7bda9e 100644 --- a/guide/api-environment-plugins.md +++ b/guide/api-environment-plugins.md @@ -1,7 +1,9 @@ # 用于插件的环境 API {#environment-api-for-plugins} -:::warning 实验性 -环境 API 仍处于实验阶段。我们仍将在主要版本之间保持 API 的稳定性,以便生态系统进行实验和构建。我们计划在下游项目有时间试验并验证新功能后,在未来的主要版本中稳定这些新 API(可能包含重大更改)。 +:::info 发布候选版本 +环境 API 目前处于发布候选阶段。我们将在主要版本发布之间保持 API 的稳定性,以便生态系统能够进行实验并在此基础上进行开发。然而,请注意,[某些特定的 API](/changes/#considering) 仍被视为实验性 API。 + +我们计划在未来主要版本发布时,待下游项目有足够时间对新功能进行实验并验证后,对这些新 API(可能包含兼容性变更)进行稳定化处理。 资料: diff --git a/guide/api-environment-runtimes.md b/guide/api-environment-runtimes.md index be763ea6..c5c99733 100644 --- a/guide/api-environment-runtimes.md +++ b/guide/api-environment-runtimes.md @@ -1,7 +1,9 @@ # 用于运行时的环境 API {#environment-api-for-runtimes} -:::warning 实验性 -环境 API 仍处于实验阶段。我们仍将在主要版本之间保持 API 的稳定性,以便生态系统进行实验和构建。我们计划在下游项目有时间试验并验证新功能后,在未来的主要版本中稳定这些新 API(可能包含重大更改)。 +:::info 发布候选版本 +环境 API 目前处于发布候选阶段。我们将在主要版本发布之间保持 API 的稳定性,以便生态系统能够进行实验并在此基础上进行开发。然而,请注意,[某些特定的 API](/changes/#considering) 仍被视为实验性 API。 + +我们计划在未来主要版本发布时,待下游项目有足够时间对新功能进行实验并验证后,对这些新 API(可能包含兼容性变更)进行稳定化处理。 资料: diff --git a/guide/api-environment.md b/guide/api-environment.md index 9ac04207..41a19574 100644 --- a/guide/api-environment.md +++ b/guide/api-environment.md @@ -1,7 +1,9 @@ # 环境 API {#environment-api} -:::warning 实验性 -环境 API 仍处于实验阶段。我们仍将在主要版本之间保持 API 的稳定性,以便生态系统进行实验和构建。我们计划在下游项目有时间试验并验证新功能后,在未来的主要版本中稳定这些新 API(可能包含重大更改)。 +:::info 发布候选版本 +环境 API 目前处于发布候选阶段。我们将在主要版本发布之间保持 API 的稳定性,以便生态系统能够进行实验并在此基础上进行开发。然而,请注意,[某些特定的 API](/changes/#considering) 仍被视为实验性 API。 + +我们计划在未来主要版本发布时,待下游项目有足够时间对新功能进行实验并验证后,对这些新 API(可能包含兼容性变更)进行稳定化处理。 资料: @@ -13,7 +15,7 @@ ## 引入环境概念 {#formalizing-environments} -Vite 6 正式引入了环境(Environments)的概念。在 Vite 5 之前,有两个隐式环境(`client`,以及可选的 `ssr`)。新的环境 API 允许用户和框架作者根据他们的应用在生产环境中的工作方式创建尽可能多的环境。这些新的功能需要大规模的内部重构,而我们也已经在保持向后兼容性上做出了很大的努力。Vite 6 的初始目标是尽可能平滑地将整个生态系统迁移到新的主要版本,直到有足够的用户已经迁移,并且框架和插件作者已经验证了新的设计后,再采用这些新的实验性 API。 +Vite 6 正式引入了“环境”的概念。在 Vite 5 之前,系统中存在两个隐式环境(`client` 和可选的 `ssr`)。新的环境 API 允许用户和框架作者根据应用在生产环境中的运行方式,创建任意数量的环境。这一新功能需要进行大规模的内部重构,但我们已投入大量精力确保向后兼容性。Vite 6 的初始目标是尽可能平滑地将生态系统迁移到新版本,推迟 API 的采用,直到足够多的用户完成迁移,且框架和插件作者已验证新设计。 ## 缩小构建和开发模式间的差距 {#closing-the-gap-between-build-and-dev} @@ -117,7 +119,7 @@ export default { ## 向后兼容性 {#backward-compatibility} -当前的 Vite 服务器 API 尚未被弃用,并且与 Vite 5 向后兼容。新的环境 API 是实验性的。 +当前的 Vite 服务器 API 尚未被弃用,并且与 Vite 5 向后兼容。 `server.moduleGraph` 返回客户端和服务器端渲染(ssr)模块图的混合视图。所有其方法都将返回向后兼容的混合模块节点。对于传递给 `handleHotUpdate` 的模块节点,也使用相同的方案。 diff --git a/guide/rolldown.md b/guide/rolldown.md index 0769eedb..8a9f6b67 100644 --- a/guide/rolldown.md +++ b/guide/rolldown.md @@ -37,7 +37,7 @@ Rolldown 专注于三个主要原则: ```json { "dependencies": { - "vite": "^6.0.0" // [!code --] + "vite": "^7.0.0" // [!code --] "vite": "npm:rolldown-vite@latest" // [!code ++] } } @@ -103,7 +103,7 @@ Rolldown 专注于三个主要原则: #### `manualChunks` 改为 `advancedChunks` {#manualchunks-changed-to-advancedchunks} -Rolldown 不再支持 Rollup 中可用的 `manualChunks` 选项。取而代之的是,它提供了一个更细粒度的设置:[`advancedChunks`](https://rolldown.rs/guide/in-depth/advanced-chunks#advanced-chunks),其行为与 webpack 的 `splitChunk` 类似。 +虽然 Rolldown 支持与 Rollup 相同的 `manualChunks` 选项,但该选项已被标记为过时。作为替代,Rolldown 通过 [`advancedChunks` 选项](https://rolldown.rs/guide/in-depth/advanced-chunks#advanced-chunks) 提供更精细的设置,该选项与 webpack 的 `splitChunk` 功能更为相似: ```js // 旧配置 (Rollup)