From 9a1e963b38e0ecc6d62d8019629ea1eed60c2bea Mon Sep 17 00:00:00 2001 From: dogle <15707274049@163.com> Date: Sat, 25 Jul 2026 14:10:09 +0800 Subject: [PATCH] docs(changes): proofread breaking change documentation --- changes/hotupdate-hook.md | 2 +- changes/index.md | 6 +++--- changes/per-environment-apis.md | 6 +++--- changes/shared-plugins-during-build.md | 4 ++-- changes/ssr-using-modulerunner.md | 4 ++-- changes/this-environment-in-hooks.md | 2 +- 6 files changed, 12 insertions(+), 12 deletions(-) diff --git a/changes/hotupdate-hook.md b/changes/hotupdate-hook.md index 509bc435..2e731e63 100644 --- a/changes/hotupdate-hook.md +++ b/changes/hotupdate-hook.md @@ -9,7 +9,7 @@ 影响范围：`Vite 插件作者` ::: warning 即将废弃 -`hotUpdate` 钩子最初在 `v6.0` 版本中引入。我们计划在未来的 major 版本中废弃 `handleHotUpdate` 钩子。我们目前还不建议你停止使用 `handleHotUpdate`。如果你想尝试并向我们提供反馈，你可以在你的 vite 配置文件中将 `future.removePluginHookHandleHotUpdate` 设置为 `"warn"`。 +`hotUpdate` 钩子最初在 `v6.0` 版本中引入。我们计划在未来的主要版本中废弃 `handleHotUpdate` 钩子。我们目前还不建议你停止使用 `handleHotUpdate`。如果你想尝试并向我们提供反馈，你可以在你的 Vite 配置文件中将 `future.removePluginHookHandleHotUpdate` 设置为 `"warn"`。 ::: ## 动机 {#motivation} diff --git a/changes/index.md b/changes/index.md index e6193514..e829dde3 100644 --- a/changes/index.md +++ b/changes/index.md @@ -1,6 +1,6 @@ # 破坏性变更 {#breaking-changes} -Vite 中的破坏性变更列表，包括 API 废弃、移除和变更。在你的 Vite 配置中，大多数下面的变更可以使用 [`future` 选项](/config/shared-options.html#future) 进行选择。 +Vite 中的破坏性变更列表，包括 API 废弃、移除和变更。在你的 Vite 配置中，大多数下面的变更可以使用 [`future` 选项](/config/shared-options.html#future) 进行选择性启用。 ## 计划中 {#planned} @@ -16,11 +16,11 @@ Vite 中的破坏性变更列表，包括 API 废弃、移除和变更。在你 我们目前还不建议你切换到这些 API。我们将它们包含在 Vite 中是为了帮助我们收集反馈。请查看这些提案，并在每个提案相关联的 GitHub Discussions 中告诉我们它们在你的使用场景中的表现如何。 -- [迁移到基于环境的API](/changes/per-environment-apis) +- [迁移到基于环境的 API](/changes/per-environment-apis) - [构建过程中的共享插件](/changes/shared-plugins-during-build) ## 历史 {#past} 以下的变更已经被实施或者撤销。在当前的主要版本中，它们已经不再相关。 -- _目前还没有历史的变更_ +- _暂无历史变更_ diff --git a/changes/per-environment-apis.md b/changes/per-environment-apis.md index e90564a7..378d85a1 100644 --- a/changes/per-environment-apis.md +++ b/changes/per-environment-apis.md @@ -1,4 +1,4 @@ -# 迁移到基于环境的API {#move-to-per-environment-apis} +# 迁移到基于环境的 API {#move-to-per-environment-apis} ::: tip 反馈 可以在 [环境 API 讨论](https://github.com/vitejs/vite/discussions/16358) 中向我们提供反馈 @@ -9,7 +9,7 @@ 影响范围：`Vite 插件作者` ::: warning 即将废弃 -`环境`实例首次在 `v6.0` 中引入。计划在未来的 major 版本中废弃现在的 `server.moduleGraph` 和其他方法。我们不建议你现在就放弃 server 方法。要识别你的使用情况，请在你的 vite 配置中设置以下。 +`环境`实例首次在 `v6.0` 中引入。计划在未来的主要版本中废弃现在的 `server.moduleGraph` 和其他方法。我们不建议你现在就放弃 server 方法。要识别你的使用情况，请在你的 Vite 配置中设置以下。 ```ts future: { @@ -28,7 +28,7 @@ future: { 在 Vite v5 及之前的版本中，一个 Vite 开发服务器总是有两个环境（`client` 和 `ssr`）。`server.moduleGraph` 混合了来自这两个环境的模块。节点通过 `clientImportedModules` 和 `ssrImportedModules` 列表连接（但每种环境只维护一个 `importers` 列表）。转换后的模块由一个 `id` 和一个 `ssr` 布尔值表示。该布尔值需要传递给 API，例如 `server.moduleGraph.getModuleByUrl(url, ssr)` 和 `server.transformRequest(url, { ssr })`。 -在 Vite v6 中，现在可以创建任意数量的自定义环境（`client`, `ssr`, `edge`等）。单一的 `ssr` 布尔值已经不够用了。我们没有将 API 改为 `server.transformRequest(url, { environment })`，而是将这些方法移到了环境实例中，这样就可以在没有 Vite dev 服务器的情况下调用这些方法。 +在 Vite v6 中，现在可以创建任意数量的自定义环境（`client`、`ssr`、`edge` 等）。单一的 `ssr` 布尔值已经不够用了。我们没有将 API 改为 `server.transformRequest(url, { environment })`，而是将这些方法移到了环境实例中，这样就可以在没有 Vite 开发服务器的情况下调用这些方法。 ## 迁移指南 {#migration-guide} diff --git a/changes/shared-plugins-during-build.md b/changes/shared-plugins-during-build.md index 3e5d243a..3314cb26 100644 --- a/changes/shared-plugins-during-build.md +++ b/changes/shared-plugins-during-build.md @@ -4,7 +4,7 @@ 可以在 [环境 API 讨论](https://github.com/vitejs/vite/discussions/16358) 中向我们提供反馈 ::: -查看 [构建过程中的共享插件](/guide/api-environment-plugins.md#shared-plugins-during-build). +查看 [构建过程中的共享插件](/guide/api-environment-plugins.md#shared-plugins-during-build)。 影响范围：`Vite 插件作者` @@ -18,7 +18,7 @@ ## 迁移指南 {#migration-guide} -为实现跨环境共享插件，插件状态必须以当前环境为关键。以下形式的插件将计算所有环境中已转换模块的数量。 +为实现跨环境共享插件，插件状态必须以当前环境为键。以下形式的插件将计算所有环境中已转换模块的数量。 ```js function CountTransformedModulesPlugin() { diff --git a/changes/ssr-using-modulerunner.md b/changes/ssr-using-modulerunner.md index dcceb502..55407f52 100644 --- a/changes/ssr-using-modulerunner.md +++ b/changes/ssr-using-modulerunner.md @@ -9,12 +9,12 @@ 影响范围：`Vite 插件作者` ::: warning 即将废弃 -`ModuleRunner` 最初在 `v6.0` 版本中被引入。我们计划在未来的主要版本中废弃 `server.ssrLoadModule`。如果想识别你的使用情况，可以在你的 vite 配置文件中将 `future.removeSsrLoadModule` 设置为 `"warn"`。 +`ModuleRunner` 最初在 `v6.0` 版本中被引入。我们计划在未来的主要版本中废弃 `server.ssrLoadModule`。如果想识别你的使用情况，可以在你的 Vite 配置文件中将 `future.removeSsrLoadModule` 设置为 `"warn"`。 ::: ## 动机 {#motivation} -`server.ssrLoadModule(url)` 仅允许在 `ssr` 环境中导入模块，并且只能在与 Vite 开发服务器相同的进程中执行这些模块。对于具有自定义环境的应用程序，每个环境都关联一个 `ModuleRunner`，该模块可能在单独的线程或进程中运行。为了导入模块，我们现在使用 `moduleRunner.import(url)`。 +`server.ssrLoadModule(url)` 仅允许在 `ssr` 环境中导入模块，并且只能在与 Vite 开发服务器相同的进程中执行这些模块。对于具有自定义环境的应用程序，每个环境都关联一个可能在单独的线程或进程中运行的 `ModuleRunner`。为了导入模块，我们现在使用 `moduleRunner.import(url)`。 ## 迁移指南 {#migration-guide} diff --git a/changes/this-environment-in-hooks.md b/changes/this-environment-in-hooks.md index 6e1d8d29..324c70af 100644 --- a/changes/this-environment-in-hooks.md +++ b/changes/this-environment-in-hooks.md @@ -9,7 +9,7 @@ 影响范围：`Vite 插件作者` ::: warning 即将废弃 -`this.environment` 最初在 `v6.0` 版本中被引入。我们计划在未来的 major 版本中废弃 `options.ssr`。到那时，我们会开始建议你将你的插件迁移到新的 API。如果想识别你的使用情况，可以在你的 vite 配置文件中将 `future.removePluginHookSsrArgument` 设置为 `"warn"`。 +`this.environment` 最初在 `v6.0` 版本中被引入。我们计划在未来的主要版本中废弃 `options.ssr`。到那时，我们会开始建议你将你的插件迁移到新的 API。如果想识别你的使用情况，可以在你的 Vite 配置文件中将 `future.removePluginHookSsrArgument` 设置为 `"warn"`。 ::: ## 动机 {#motivation}