Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion changes/hotupdate-hook.md
Original file line number Diff line number Diff line change
Expand Up @@ -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}
Expand Down
6 changes: 3 additions & 3 deletions changes/index.md
Original file line number Diff line number Diff line change
@@ -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}

Expand All @@ -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}

以下的变更已经被实施或者撤销。在当前的主要版本中,它们已经不再相关。

- _目前还没有历史的变更_
- _暂无历史变更_
6 changes: 3 additions & 3 deletions changes/per-environment-apis.md
Original file line number Diff line number Diff line change
@@ -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) 中向我们提供反馈
Expand All @@ -9,7 +9,7 @@
影响范围:`Vite 插件作者`

::: warning 即将废弃
`环境`实例首次在 `v6.0` 中引入。计划在未来的 major 版本中废弃现在的 `server.moduleGraph` 和其他方法。我们不建议你现在就放弃 server 方法。要识别你的使用情况,请在你的 vite 配置中设置以下。
`环境`实例首次在 `v6.0` 中引入。计划在未来的主要版本中废弃现在的 `server.moduleGraph` 和其他方法。我们不建议你现在就放弃 server 方法。要识别你的使用情况,请在你的 Vite 配置中设置以下。

```ts
future: {
Expand All @@ -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}

Expand Down
4 changes: 2 additions & 2 deletions changes/shared-plugins-during-build.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 插件作者`

Expand All @@ -18,7 +18,7 @@

## 迁移指南 {#migration-guide}

为实现跨环境共享插件,插件状态必须以当前环境为关键。以下形式的插件将计算所有环境中已转换模块的数量。
为实现跨环境共享插件,插件状态必须以当前环境为键。以下形式的插件将计算所有环境中已转换模块的数量。

```js
function CountTransformedModulesPlugin() {
Expand Down
4 changes: 2 additions & 2 deletions changes/ssr-using-modulerunner.md
Original file line number Diff line number Diff line change
Expand Up @@ -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}

Expand Down
2 changes: 1 addition & 1 deletion changes/this-environment-in-hooks.md
Original file line number Diff line number Diff line change
Expand Up @@ -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}
Expand Down