Merge pull request #1560 from vitejs/dev

d2m

Author: thinkasany

guide/migration.md

@@ -15,7 +15,7 @@
 
 ## Rolldown {#rolldown}
 
-Vite 8 使用基于 Rolldown 和 Oxc 的工具，而不是 esbuild 和 Rollup。
+Vite 8 使用基于 [Rolldown](https://rolldown.rs/) 和 [Oxc](https://oxc.rs/) 的工具，而不是 [esbuild](https://esbuild.github.io/) 和 [Rollup](https://rollupjs.org/)。
 
 ### 渐进式迁移 {#gradual-migration}
 
@@ -270,7 +270,7 @@ Lightning CSS 支持更好的语法降级，你的 CSS 包大小可能会略有
 
 ### 外部化模块的 Require 调用 {#require-calls-for-externalized-modules}
 
-现在外部化模块的 `require` 调用会被保留为 `require` 调用，而不会被转换为 `import` 语句。这是为了保持 `require` 调用的语义。如果你想将它们转换为 `import` 语句，可以使用 Rolldown 内置的 `esmExternalRequirePlugin`，该插件由 `vite` 重新导出。
+现在外部化模块的 `require` 调用会被保留为 `require` 调用，而不会被转换为 `import` 语句。这是为了保持 `require` 调用的语义。如果你想将它们转换为 `import` 语句，可以使用 [Rolldown 内置的 `esmExternalRequirePlugin`](https://rolldown.rs/builtin-plugins/esm-external-require)，该插件由 `vite` 重新导出。
 
 ```js
 import { defineConfig, esmExternalRequirePlugin } from 'vite'
@@ -328,9 +328,7 @@ const plugin = {
 - `worker.rollupOptions`：重命名为 `worker.rolldownOptions`
 - `build.commonjsOptions`：现在无操作效果
 - `build.dynamicImportVarsOptions.warnOnError`: 现在无操作效果
-- `resolve.alias[].customResolver`: 请改用带有 `resolveId` 钩子的自定义插件。
-
-## 总体变化 [<Badge text="NRV" type="warning" />](#migration-from-v7) {#general-changes}
+- `resolve.alias[].customResolver`：请改用带有 `resolveId` 钩子和 `enforce: 'pre'` 的自定义插件。
 
 ## 移除了已弃用的功能 [<Badge text="NRV" type="warning" />](#migration-from-v7) {#removed-deprecated-features}
 
@@ -340,8 +338,6 @@ const plugin = {
 
 还有其他一些只影响少数用户的破坏性更改。
 
-- **[TODO: 这将在稳定版发布前修复]** https://github.com/rolldown/rolldown/issues/5726 (affects nuxt, qwik)
-- **[TODO: 这将在稳定版发布前修复]** `@vite-ignore` 注释边缘情况 ([rolldown-vite#426](https://github.com/vitejs/rolldown-vite/issues/426))
 - [Extglobs](https://github.com/micromatch/picomatch/blob/master/README.md#extglobs) 尚未得到支持 ([rolldown-vite#365](https://github.com/vitejs/rolldown-vite/issues/365))
 - **TypeScript 旧版命名空间仅部分支持**：TypeScript 的旧版命名空间功能现在只得到部分支持。更多详情请参阅 [Oxc 转换器的相关文档](https://oxc.rs/docs/guide/usage/transformer/typescript.html#partial-namespace-support)。
 - `define` 不共享对象引用：当你传递一个对象作为 `define` 的值时，每个变量都会有一个单独的对象副本。详见 [Oxc 转换器的相关文档](https://oxc.rs/docs/guide/usage/transformer/global-variable-replacement#define)。
@@ -361,6 +357,7 @@ const plugin = {
   - `renderDynamicImport` 钩子 ([rolldown#4532](https://github.com/rolldown/rolldown/issues/4532))
   - `resolveFileUrl` 钩子
 - `parseAst` / `parseAstAsync` 函数现在已被弃用，推荐使用功能更多的 `parseSync` / `parse` 函数。
+- （bug）`@vite-ignore` 注释的边界情况 ([rolldown-vite#426](https://github.com/vitejs/rolldown-vite/issues/426))
 
 ## 从 v6 迁移 {#migration-from-v6}