@modern-js/main-doc 3.9.2 → 3.10.0

package/docs/zh/community/blog/v3-release-note.mdx

@@ -44,11 +44,11 @@ Modern.js 3.0 集成 React Server Component，支持 CSR 和 SSR 项目，并支
 
 React Server Components（服务端组件）是一种新的组件类型，它允许**组件逻辑完全在服务端执行**，并直接将渲染后的 UI 流式传输到客户端。与传统的客户端组件相比，服务端组件带来了以下特性：
 
-| 特性 | 说明 |
-| --- | --- |
-| 零客户端包体积 | 组件代码不包含在客户端 JS Bundle 中，仅在服务端执行，加快首屏加载与渲染速度 |
-| 更高的内聚性 | 组件可直接连接数据库、调用内部 API、读取本地文件，提高开发效率 |
-| 渐进增强 | 可与客户端组件无缝混合使用，按需下放交互逻辑到客户端，在保持高性能的同时，支持复杂交互体验 |
+| 特性           | 说明                                                                                       |
+| -------------- | ------------------------------------------------------------------------------------------ |
+| 零客户端包体积 | 组件代码不包含在客户端 JS Bundle 中，仅在服务端执行，加快首屏加载与渲染速度                |
+| 更高的内聚性   | 组件可直接连接数据库、调用内部 API、读取本地文件，提高开发效率                             |
+| 渐进增强       | 可与客户端组件无缝混合使用，按需下放交互逻辑到客户端，在保持高性能的同时，支持复杂交互体验 |
 
 需要明确的是，RSC 和 SSR 是**截然不同的概念**：
 
@@ -67,7 +67,7 @@ React Server Components（服务端组件）是一种新的组件类型，它允
 export default defineConfig({
   server: {
     rsc: true,
-  }
+  },
 });
 ```
 
@@ -75,7 +75,14 @@ export default defineConfig({
 配置启用后，所有的路由组件都会默认成为 Server Component。项目中可能存在无法在服务端运行的组件，你可以先为这些组件添加 `'use client'` 标记，以保持原有行为，再逐步迁移。
 :::
 
-<video src="https://lf3-static.bytednsdoc.com/obj/eden-cn/nuvjhpqnuvr/rsc.mp4" controls autoplay loop muted style={{ width: '100%', borderRadius: 8 }} />
+<video
+  src="https://lf3-static.bytednsdoc.com/obj/eden-cn/nuvjhpqnuvr/rsc.mp4"
+  controls
+  autoplay
+  loop
+  muted
+  style={{ width: '100%', borderRadius: 8 }}
+/>
 
 #### Modern.js 3.0 的 RSC 特性
 
@@ -156,7 +163,7 @@ import('./module').then(({ value }) => {
 });
 
 // 函数体内的解构访问
-import('./module').then((mod) => {
+import('./module').then(mod => {
   const { value } = mod;
   console.log(value);
 });
@@ -236,7 +243,10 @@ export default defineRuntimeConfig({
 在 Modern.js 3.0 中，我们使用 [Hono](https://hono.dev) 重构了 Web Server，并正式开放了服务端中间件与插件的能力。开发者可以使用 Hono 的中间件来完成需求：
 
 ```ts title="server/modern.server.ts"
-import { defineServerConfig, type MiddlewareHandler } from "@modern-js/server-runtime";
+import {
+  defineServerConfig,
+  type MiddlewareHandler,
+} from '@modern-js/server-runtime';
 
 const timingMiddleware: MiddlewareHandler = async (c, next) => {
   const start = Date.now();
@@ -249,8 +259,8 @@ const htmlMiddleware: MiddlewareHandler = async (c, next) => {
   await next();
   const html = await c.res.text();
   const modified = html.replace(
-    "<head>",
-    '<head><meta name="generator" content="Modern.js">'
+    '<head>',
+    '<head><meta name="generator" content="Modern.js">',
   );
   c.res = c.body(modified, { status: c.res.status, headers: c.res.headers });
 };
@@ -321,13 +331,13 @@ React Router v6 是一个重要的过渡版本，它引入了许多新特性（
 因此，Modern.js 3.0 提供了完整的配置式路由支持，可以与约定式路由一起使用，或两者分别单独使用。
 
 ```ts title="src/modern.routes.ts"
-import { defineRoutes } from "@modern-js/runtime/config-routes";
+import { defineRoutes } from '@modern-js/runtime/config-routes';
 
 export default defineRoutes(({ route, layout, page }) => {
   return [
-    route("home.tsx", "/"),
-    route("about.tsx", "about"),
-    route("blog.tsx", "blog/:id"),
+    route('home.tsx', '/'),
+    route('about.tsx', 'about'),
+    route('blog.tsx', 'blog/:id'),
   ];
 });
 ```
@@ -364,8 +374,7 @@ Modern.js 3.0 重做了 SSG 能力，提供了灵活的缓存能力，对降级
 - 简化了 API，降低理解成本
 - 与约定式路由更好地结合
 
-
-在新版本中，你可以通过  data loader 进行数据获取，与非 SSG 场景保持一致。然后在 ssg.routes 配置中即可直接指定要渲染的路由：
+在新版本中，你可以通过 data loader 进行数据获取，与非 SSG 场景保持一致。然后在 ssg.routes 配置中即可直接指定要渲染的路由：
 
 ```ts title="modern.config.ts"
 export default defineConfig({
@@ -414,19 +423,19 @@ export const cacheOption: CacheOption = {
 我们在新版本中提供了 `cache` 函数，相比渲染缓存它提供了更精细的数据粒度控制。当多个数据请求依赖同一份数据时，`cache` 可以避免重复请求：
 
 ```ts title="server/loader.ts"
-import { cache } from "@modern-js/runtime/cache";
-import { fetchUserData, fetchUserProjects, fetchUserTeam } from "./api";
+import { cache } from '@modern-js/runtime/cache';
+import { fetchUserData, fetchUserProjects, fetchUserTeam } from './api';
 
 // 缓存用户数据，避免重复请求
 const getUser = cache(fetchUserData);
 
 const getProjects = async () => {
-  const user = await getUser("test-user");
+  const user = await getUser('test-user');
   return fetchUserProjects(user.id);
 };
 
 const getTeam = async () => {
-  const user = await getUser("test-user"); // 复用缓存，不会重复请求
+  const user = await getUser('test-user'); // 复用缓存，不会重复请求
   return fetchUserTeam(user.id);
 };
 
@@ -445,14 +454,14 @@ export const loader = async () => {
 
 在实践过程中，我们沉淀了多维度的降级策略：
 
-| 类型 | 触发方式 | 降级行为 | 使用场景 |
-| --- | --- | --- | --- |
-| 异常降级 | Data Loader 执行报错 | 触发 ErrorBoundary | 数据请求异常兜底 |
-| 组件渲染报错 | 服务端渲染异常 | 降级到 CSR，复用已有数据渲染 | 服务端渲染异常兜底 |
-| 业务降级 | Loader 抛出 `throw Response` | 触发 ErrorBoundary，返回对应 HTTP 状态码 | 404、权限校验等业务场景 |
-| 配置 Client Loader | 配置 Client Loader | 绕过 SSR，直接请求数据源 | 需要在客户端直接获取数据的场景 |
-| 强制降级 | Query 参数 `?__csr=true` | 跳过 SSR，返回 CSR 页面 | 调试、临时降级 |
-| 强制降级 | 请求头 `x-modern-ssr-fallback` | 跳过 SSR，返回 CSR 页面 | 网关层控制降级 |
+| 类型               | 触发方式                       | 降级行为                                 | 使用场景                       |
+| ------------------ | ------------------------------ | ---------------------------------------- | ------------------------------ |
+| 异常降级           | Data Loader 执行报错           | 触发 ErrorBoundary                       | 数据请求异常兜底               |
+| 组件渲染报错       | 服务端渲染异常                 | 降级到 CSR，复用已有数据渲染             | 服务端渲染异常兜底             |
+| 业务降级           | Loader 抛出 `throw Response`   | 触发 ErrorBoundary，返回对应 HTTP 状态码 | 404、权限校验等业务场景        |
+| 配置 Client Loader | 配置 Client Loader             | 绕过 SSR，直接请求数据源                 | 需要在客户端直接获取数据的场景 |
+| 强制降级           | Query 参数 `?__csr=true`       | 跳过 SSR，返回 CSR 页面                  | 调试、临时降级                 |
+| 强制降级           | 请求头 `x-modern-ssr-fallback` | 跳过 SSR，返回 CSR 页面                  | 网关层控制降级                 |
 
 ---
 

package/docs/zh/community/contributing-guide.mdx

@@ -20,7 +20,7 @@ sidebar_position: 3
 node -v
 ```
 
-如果你当前环境没有安装 Node.js，可以使用 [nvm](https://github.com/nvm-sh/nvm)或者 [fnm](https://github.com/Schniz/fnm) 来安装它。
+如果你当前环境没有安装 Node.js，可以使用 [nvm](https://github.com/nvm-sh/nvm) 或者 [fnm](https://github.com/Schniz/fnm) 来安装它。
 
 以下是如何通过 nvm 安装 Node.js 22 LTS 版本的示例：
 
@@ -35,13 +35,6 @@ nvm alias default 22
 nvm use 22
 ```
 
-### 安装 pnpm
-
-```bash
-# 使用 corepack 启用 pnpm，仅在 Node.js >= `v14.19.0` 上可用
-corepack enable
-```
-
 ### 安装依赖
 
 ```sh
@@ -56,28 +49,6 @@ pnpm install
 
 > 在此之后，你通常不需要一次性构建所有 packages。如果你正在开发的新功能依赖另一个 package 的最新代码，通常只构建指定的 package 就足够了。
 
-### 设置 Git 邮箱
-
-请确保在 `<https://github.com/settings/emails>` 中设置了电子邮件，当你提交 Pull Request 时将需要它。
-
-检查你的 git 客户端是否已配置邮箱：
-
-```sh
-git config --list | grep email
-```
-
-全局设置邮箱：
-
-```sh
-git config --global user.email "SOME_EMAIL@example.com"
-```
-
-针对本地仓库设置邮箱：
-
-```sh
-git config user.email "SOME_EMAIL@example.com"
-```
-
 ## 代码变更和构建
 
 当你在 fork 的仓库中设置完本地开发环境后，我们就可以开始开发了。
@@ -131,7 +102,7 @@ Modern.js 仓库的单元测试统一使用 [Rstest](https://rstest.rs/)。你
 在提交 pull request 之前，为了确保本次变更没有引入缺陷，你可以通过执行以下命令运行单元测试：
 
 ```sh
-pnpm run test
+pnpm run test:ut
 ```
 
 你也可以使用 `--filter` 选项运行单个包的单元测试：
@@ -144,10 +115,11 @@ pnpm run --filter @modern-js/some-package test
 
 除了单元测试之外，Modern.js 仓库还包括端到端 (E2E) 测试，用于检查整个应用程序的功能。
 
-你可以执行 `test:e2e` 命令来运行 E2E 测试：
+使用以下命令运行框架集成测试和 Builder E2E 测试：
 
 ```sh
-pnpm run test:e2e
+pnpm run test:framework
+pnpm run test:builder
 ```
 
 如果需要运行指定的测试，可以添加关键字进行过滤：
@@ -159,7 +131,7 @@ npx rstest copy-assets
 
 ## Linting
 
-为了帮助保持代码风格的一致性和可读性，我们使用 ESLint 对代码进行校验。
+为了帮助保持代码风格的一致性和可读性，我们使用 [Rstack CLI](https://rstack.rs/) 进行代码校验和格式化。
 
 你可以执行以下命令来运行 Linter：
 
@@ -167,6 +139,14 @@ npx rstest copy-assets
 pnpm run lint
 ```
 
+在仓库根目录运行格式化命令：
+
+```sh
+pnpm run format
+```
+
+可以在命令后追加文件或目录路径来缩小范围。
+
 ## Benchmarking
 
 你可以在 PR 的评论区中输入 `!bench-framework` 或 `!bench-module` 分别对 `@modern-js/app-tools` 和 `@modern-js/module-tools` 做性能测试（这需要你具有 Collaborator 及以上的权限）。
@@ -248,6 +228,8 @@ pnpm prepare
 pnpm run bump
 ```
 
+该命令会先通过 Changesets 升级包版本，再自动将内部 `peerDependencies` 范围同步为 `workspace:^<依赖包版本>`，与 changeset 校验保持一致。
+
 5. 提交版本变更。
 
 ```sh

package/docs/zh/components/default-browserslist.mdx

@@ -1,4 +1,3 @@
-
 ```yaml title=".browserslistrc"
 chrome >= 87
 edge >= 88

package/docs/zh/components/deploy-command.mdx

@@ -11,4 +11,4 @@ Options:
   -h, --help            显示命令帮助
 ```
 
-详细内容可以参考 [部署应用](/guides/basic-features/deploy)。
+详细内容可以参考 [部署应用](/guides/basic-features/deploy)。

package/docs/zh/components/deploy.mdx

@@ -1 +1 @@
-本地验证完成后，可以参考 [部署](/guides/basic-features/deploy.html) 一节，将项目部署到服务器上。
+本地验证完成后，可以参考 [部署](/guides/basic-features/deploy.html) 一节，将项目部署到服务器上。

package/docs/zh/components/entry-scan-logic.mdx

@@ -1,7 +1,7 @@
 :::tip 入口扫描逻辑
+
 - 如果 `src/` 本身满足入口条件 → 单入口应用
 - 如果 `src/` 不满足条件 → 扫描 `src/` 下的子目录 → 多入口应用
 - 单入口应用中，默认入口名为 `index`
 
 :::
-

package/docs/zh/components/init-app.mdx

@@ -38,19 +38,18 @@ npx @modern-js/create@latest myapp
 
 ⚡ 启动开发服务器：
 
-  pnpm start
+  pnpm dev
 ```
 
 现在，项目结构如下：
 
 ```
 .
-├── biome.json
 ├── modern.config.ts
 ├── package.json
 ├── README.md
+├── rstack.config.mts
 ├── src
-│   ├── modern-app-env.d.ts
 │   ├── modern.runtime.ts
 │   └── routes
 │       ├── index.css
@@ -58,3 +57,10 @@ npx @modern-js/create@latest myapp
 │       └── page.tsx
 └── tsconfig.json
 ```
+
+新建的独立项目使用 [Rstack CLI](https://rstack.rs/) 进行代码校验和格式化：
+
+```bash
+pnpm check
+pnpm format
+```

package/docs/zh/components/international/custom-instance-code.mdx

@@ -13,4 +13,3 @@ export default defineRuntimeConfig({
   },
 });
 ```
-

package/docs/zh/components/international/install-command.mdx

@@ -4,7 +4,6 @@
 `@modern-js/plugin-i18n` 需要与项目中 `@modern-js/app-tools` 版本保持一致。
 :::
 
-
 ```bash
 pnpm list @modern-js/app-tools
 pnpm add @modern-js/plugin-i18n@<version> i18next react-i18next

package/docs/zh/components/micro-runtime-config.mdx

@@ -3,15 +3,18 @@ import { defineRuntimeConfig } from '@modern-js/runtime';
 
 export default defineRuntimeConfig({
   masterApp: {
-    apps: [{
-      name: 'Table',
-      entry: 'http://localhost:8081',
-      // activeWhen: '/table'
-    }, {
-      name: 'Dashboard',
-      entry: 'http://localhost:8082'
-      // activeWhen: '/dashboard'
-    }]
+    apps: [
+      {
+        name: 'Table',
+        entry: 'http://localhost:8081',
+        // activeWhen: '/table'
+      },
+      {
+        name: 'Dashboard',
+        entry: 'http://localhost:8082',
+        // activeWhen: '/dashboard'
+      },
+    ],
   },
 });
 ```

package/docs/zh/components/nodeVersion.mdx

@@ -1,4 +1,4 @@
-在开始使用前，你需要安装 [Node.js](https://nodejs.org/)，并保证 Node.js 版本不低于 v20.19.5，**我们推荐使用 Node.js 22 的 LTS 版本**。
+在开始使用前，你需要安装 [Node.js](https://nodejs.org/)，并保证 Node.js 版本不低于 v22.18.0，**我们推荐使用 Node.js 22 的 LTS 版本**。
 
 你可以通过以下命令检查当前使用的 Node.js 版本：
 
@@ -6,7 +6,7 @@
 node -v
 ```
 
-如果你当前的环境中尚未安装 Node.js，或是安装的版本低于 v20.19.5，可以通过 [nvm](https://github.com/nvm-sh/nvm) 或 [fnm](https://github.com/Schniz/fnm) 安装需要的版本。
+如果你当前的环境中尚未安装 Node.js，或是安装的版本不满足此要求，可以通过 [nvm](https://github.com/nvm-sh/nvm) 或 [fnm](https://github.com/Schniz/fnm) 安装需要的版本。
 
 下面是通过 nvm 安装 Node.js 22 LTS 版本的例子：
 

package/docs/zh/components/rsc-deploy-tip.mdx

@@ -1 +0,0 @@
-

package/docs/zh/components/ssr-monitor.mdx

@@ -1,3 +1,3 @@
 :::tip
 SSR 相关的数据监控已整合到 Monitors 模块中，详见 [Monitors](/guides/advanced-features/server-monitor/monitors)。
-:::
+:::

package/docs/zh/configure/app/bff/cross-project.mdx

@@ -7,7 +7,7 @@ title: crossProject
 - **类型：** `boolean`
 - **默认值：** `false`
 
-import EnableBFFCaution from "@site-docs/components/enable-bff-caution";
+import EnableBFFCaution from '@site-docs/components/enable-bff-caution';
 
 <EnableBFFCaution />
 
@@ -21,4 +21,4 @@ export default defineConfig({
 });
 ```
 
-有关 BFF 跨项目调用的详细配置和使用方法，请参考 [BFF 跨项目调用指南](/guides/advanced-features/bff/cross-project.html)。
+有关 BFF 跨项目调用的详细配置和使用方法，请参考 [BFF 跨项目调用指南](/guides/advanced-features/bff/cross-project.html)。

package/docs/zh/configure/app/bff/prefix.mdx

@@ -7,7 +7,7 @@ title: prefix
 - **类型：** `string`
 - **默认值：** `/api`
 
-import EnableBFFCaution from "@site-docs/components/enable-bff-caution";
+import EnableBFFCaution from '@site-docs/components/enable-bff-caution';
 
 <EnableBFFCaution />
 

package/docs/zh/configure/app/dev/lazy-compilation.mdx

@@ -33,10 +33,26 @@ type LazyCompilationOptions =
     };
 ```
 
-- **默认值：** `false`
+- **默认值：** 取决于应用的渲染方式：
+  - 纯 CSR 与流式 SSR 应用：`{ imports: true, entries: false }`，即对动态导入按需编译；
+  - 使用 string SSR（包括 `server.ssrByEntries` 中任一入口为 string SSR）、RSC 或 SSG 的应用：`false`。
 
 用于开启 lazy compilation（即按需编译），基于 Rspack 的 [lazy compilation](https://rspack.rs/zh/guide/features/lazy-compilation) 特性实现。
 
+该配置仅在开发环境（dev server）下生效，不影响生产构建产物。流式 SSR 应用开启时，路由组件仍会提前编译，以保证首屏 JS/CSS 注入正确。
+
+显式配置的 `dev.lazyCompilation` 始终优先于默认值，如需关闭可配置：
+
+```ts
+import { defineConfig } from '@modern-js/app-tools';
+
+export default defineConfig({
+  dev: {
+    lazyCompilation: false,
+  },
+});
+```
+
 import RsbuildLink from '@site/src/components/RsbuildLink';
 
 :::info

package/docs/zh/configure/app/html/crossorigin.mdx

@@ -9,7 +9,6 @@ title: crossorigin
 
 用于设置 `<script>` 和 `<style>` 标签的 [crossorigin](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/crossorigin) 属性。
 
-
 import RsbuildConfig from '@site-docs/components/rsbuild-config-tooltip';
 
 <RsbuildConfig configName="html.crossorigin" />

package/docs/zh/configure/app/html/favicon.mdx

@@ -15,7 +15,6 @@ title: favicon
 
 配置该选项后，在编译过程中会自动将图标拷贝至 dist 目录下，并在 HTML 中添加相应的 `link` 标签。
 
-
 import RsbuildConfig from '@site-docs/components/rsbuild-config-tooltip';
 
 <RsbuildConfig configName="html.favicon" />

package/docs/zh/configure/app/output/convert-to-rem.mdx

@@ -81,4 +81,3 @@ export default {
 ```
 
 详细用法可参考 [rsbuild-plugin-rem](https://github.com/rstackjs/rsbuild-plugin-rem)。
-

package/docs/zh/configure/app/output/css-modules.mdx

@@ -17,11 +17,7 @@ type CssModules = {
         resourceFragment: string,
       ) => boolean);
   exportLocalsConvention?:
-    | 'asIs'
-    | 'camelCase'
-    | 'camelCaseOnly'
-    | 'dashes'
-    | 'dashesOnly';
+    'asIs' | 'camelCase' | 'camelCaseOnly' | 'dashes' | 'dashesOnly';
   exportGlobals?: boolean;
   localIdentName?: string;
   mode?:

package/docs/zh/configure/app/output/disable-svgr.mdx

@@ -7,6 +7,10 @@ title: disableSvgr
 - **类型：** `boolean`
 - **默认值：** `false`
 
+:::warning 已废弃
+`output.disableSvgr` 已废弃，并将在下一个大版本中移除。`output.disableSvgr: true` 请改为 [tools.svgr](/configure/app/tools/svgr) 设置为 `false`；`output.disableSvgr: false` 是默认行为，直接删除即可。两者同时设置时，以 `tools.svgr` 为准。
+:::
+
 是否调用 SVGR 将 SVG 转化为 React 组件。如果设置为 true，将把所有的.svg 文件视为资源处理。
 
 默认情况下，在 JS 文件中引用 SVG 资源时，Modern.js 会调用 SVGR，将 SVG 图片转换为一个 React 组件。

package/docs/zh/configure/app/output/inline-scripts.mdx

@@ -8,8 +8,7 @@ title: inlineScripts
 
 ```ts
 type InlineScriptsTest =
-  | RegExp
-  | ((params: { size: number; name: string }) => boolean);
+  RegExp | ((params: { size: number; name: string }) => boolean);
 
 type InlineScripts =
   | boolean

package/docs/zh/configure/app/output/inline-styles.mdx

@@ -8,8 +8,7 @@ title: inlineStyles
 
 ```ts
 type InlineStylesTest =
-  | RegExp
-  | ((params: { size: number; name: string }) => boolean);
+  RegExp | ((params: { size: number; name: string }) => boolean);
 
 type InlineStyles =
   | boolean

package/docs/zh/configure/app/output/source-map.mdx

@@ -34,5 +34,3 @@ const defaultSourceMap = {
 import RsbuildConfig from '@site-docs/components/rsbuild-config-tooltip';
 
 <RsbuildConfig configName="output.sourceMap" />
-
-

package/docs/zh/configure/app/output/split-route-chunks.mdx

@@ -16,5 +16,5 @@ export default {
   output: {
     splitRouteChunks: false,
   },
-}
+};
 ```

package/docs/zh/configure/app/output/ssg.mdx

@@ -20,6 +20,7 @@ SSG 功能使用与路由关联性较大，建议使用前先了解[路由方案
 :::
 
 :::info
+
 - 单入口建议使用 `output.ssg`。
 - 多入口建议优先使用 `output.ssgByEntries`。
 - 当 `output.ssg` 为 `true` 且未配置 `output.ssgByEntries` 时，所有入口下的所有路由都会作为 SSG 路由处理。

package/docs/zh/configure/app/output/ssgByEntries.mdx

@@ -10,13 +10,13 @@ title: ssgByEntries
 在多入口应用中，为每个入口分别配置 SSG。
 
 :::info
+
 - 单入口建议使用 `output.ssg`。
 - 多入口建议优先使用 `output.ssgByEntries`。
 - 当 `output.ssg` 为 `true` 且未配置 `output.ssgByEntries` 时，所有入口下的所有路由都会作为 SSG 路由处理。
 
 :::
 
-
 ## 配置类型
 
 ```ts

package/docs/zh/configure/app/output/svg-default-export.mdx

@@ -7,6 +7,10 @@ title: svgDefaultExport
 - **类型：** `'url' | 'component'`
 - **默认值：** `'url'`
 
+:::warning 已废弃
+`output.svgDefaultExport` 已废弃，并将在下一个大版本中移除，请改用 [tools.svgr](/configure/app/tools/svgr) 的 `svgrOptions.exportType`：`'component'` 对应 `exportType: 'default'`，`'url'` 对应 `exportType: 'named'`。两者同时设置时，以 `tools.svgr` 为准。
+:::
+
 `output.svgDefaultExport` 可以用来配置 SVG 文件的默认导出。
 
 当 `output.svgDefaultExport` 配置为 `url` 时，SVG 文件的默认导出是文件的 URL。例如：

package/docs/zh/configure/app/performance/chunk-split.mdx

@@ -14,10 +14,7 @@ type ForceSplitting = RegExp[] | Record<string, RegExp>;
 
 interface BaseChunkSplit {
   strategy?:
-    | 'split-by-module'
-    | 'split-by-experience'
-    | 'all-in-one'
-    | 'single-vendor';
+    'split-by-module' | 'split-by-experience' | 'all-in-one' | 'single-vendor';
   override?: SplitChunks;
   forceSplitting?: ForceSplitting;
 }

package/docs/zh/configure/app/resolve/dedupe.mdx

@@ -8,7 +8,6 @@ title: dedupe
 
 强制 Rsbuild 从项目根目录解析指定的包，这可以用于移除重复包和减少包大小。对应 Rsbuild 的 [resolve.dedupe](https://v2.rsbuild.rs/config/resolve/dedupe) 配置。
 
-
 import RsbuildConfig from '@site-docs/components/rsbuild-config-tooltip';
 
 <RsbuildConfig configName="resolve.dedupe" />

package/docs/zh/configure/app/runtime/plugins.mdx

@@ -50,9 +50,11 @@ import { defineRuntimeConfig } from '@modern-js/runtime';
 import { myPlugin } from './config/plugin/myPlugin';
 
 export default defineRuntimeConfig({
-  plugins: [myPlugin({
-    foo: 1,
-    bar: 2,
-  })],
+  plugins: [
+    myPlugin({
+      foo: 1,
+      bar: 2,
+    }),
+  ],
 });
 ```

package/docs/zh/configure/app/server/rsc.mdx

@@ -21,10 +21,10 @@ export default defineConfig({
 
 :::tip 前置条件
 在启用 RSC 之前，请确保：
+
 1. React 和 React DOM 已升级到 19 版本（建议 19.2.4 以上版本）
 2. 已安装 `react-server-dom-rspack@0.0.2` 依赖
 
 :::
 
 有关使用 RSC 的更多信息，请参阅 [React Server Components 指南](/guides/basic-features/render/rsc)。
-

package/docs/zh/configure/app/server/ssr.mdx

@@ -25,13 +25,12 @@ export default defineConfig({
 
 当值类型为 `Object` 时，可以配置如下属性：
 
-| 属性              | 类型                                                               | 默认值                                   | 描述                                                                     |
-| ---------------- | ------------------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------- |
-| mode             | `string`                                  | `stream`          | 默认为使用流式渲染。配置为 `string` 使用 `renderToString` 渲染       |
-| forceCSR         | `boolean`                                 | `false`           | 默认关闭强制 CSR 渲染。配置为 `true` 后，在页面访问时添加 `?csr=true` 或添加请求头 `x-modern-ssr-fallback` 即可强制 CSR |
-| unsafeHeaders    | `string[]`                                | `[]`              | 为了安全考虑，Modern.js 不会往 SSR_DATA 添加过多的内容。开发者可以通过该配置，对需要注入的 headers 进行配置       |
-| loaderFailureMode| `clientRender \| errorBoundary`           | `errorBoundary` | 当 [data loader](/guides/basic-features/data/data-fetch.html#data-loader推荐) 中出错时，默认会渲染路由 [`Error`](/guides/basic-features/routes/routes#错误处理) 组件，配置为 `'clientRender'` 时，有一个 data loader 抛错，就降级到客户端渲染，可以与 [Client Loader](/guides/basic-features/data/data-fetch.html#client-loader) 配合使用 |
-
+| 属性              | 类型                            | 默认值          | 描述                                                                                                                                                                                                                                                                                                                                      |
+| ----------------- | ------------------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| mode              | `string`                        | `stream`        | 默认为使用流式渲染。配置为 `string` 使用 `renderToString` 渲染                                                                                                                                                                                                                                                                            |
+| forceCSR          | `boolean`                       | `false`         | 默认关闭强制 CSR 渲染。配置为 `true` 后，在页面访问时添加 `?csr=true` 或添加请求头 `x-modern-ssr-fallback` 即可强制 CSR                                                                                                                                                                                                                   |
+| unsafeHeaders     | `string[]`                      | `[]`            | 为了安全考虑，Modern.js 不会往 SSR_DATA 添加过多的内容。开发者可以通过该配置，对需要注入的 headers 进行配置                                                                                                                                                                                                                               |
+| loaderFailureMode | `clientRender \| errorBoundary` | `errorBoundary` | 当 [data loader](/guides/basic-features/data/data-fetch.html#data-loader推荐) 中出错时，默认会渲染路由 [`Error`](/guides/basic-features/routes/routes#错误处理) 组件，配置为 `'clientRender'` 时，有一个 data loader 抛错，就降级到客户端渲染，可以与 [Client Loader](/guides/basic-features/data/data-fetch.html#client-loader) 配合使用 |
 
 ```ts title="modern.config.ts"
 export default defineConfig({