const defaultConfig = {
analyzerMode: 'static',
@@ -292,9 +292,9 @@ 默认值： undefined
-
为哪些资源配置 dns-prefetch 属性。
+为哪些资源配置 dns-prefetch 属性。
配置该属性可以在请求资源之前解析域名，降低请求延迟，提升加载性能。
-更多信息可参考：Using dns-prefetch
+更多信息可参考：Using dns-prefetch
示例
export default {
performance: {
@@ -312,7 +312,7 @@
默认值： undefined
-为哪些资源配置 preconnect 属性。
+为哪些资源配置 preconnect 属性。
配置该属性会预先建立与服务器的连接，如果站点是 HTTPS 的，则此过程包括 DNS 解析，建立 TCP 连接以及执行 TLS 握手。将 Preconnect 和 DnsPrefetch 结合使用可进一步减少跨域请求的延迟。
示例
export default {
@@ -336,7 +336,7 @@
默认值： undefined
-为哪些资源配置 prefetch 属性。
+为哪些资源配置 prefetch 属性。
该属性用于配置在将来某些导航下可能需要的资源，此时，浏览器通常在空闲状态时获取此资源。
Boolean 类型
当设置 performance.prefetch 为 true，将根据如下配置对资源进行预获取:
@@ -380,7 +380,7 @@
默认值： undefined
-为哪些资源配置 preload 属性。
+为哪些资源配置 preload 属性。
该属性通常用于配置当前导航下可能需要的资源，此时，浏览器通常以中等优先级（不是布局阻塞）获取此资源。
Boolean 类型
当设置 performance.preload 为 true，将根据如下配置对资源进行预加载:
@@ -433,7 +433,7 @@ 类型： boolean
默认值： false
-是否捕获每个模块的耗时信息，对应 webpack / Rspack 的 profile 配置。
+是否捕获每个模块的耗时信息，对应 webpack / Rspack 的 profile 配置。
示例
export default {
performance: {
@@ -468,7 +468,7 @@ 类型： boolean
默认值： false
-是否移除 moment.js 的语言包文件。
+是否移除 moment.js 的语言包文件。
moment.js 默认包含了大量的语言包文件，会导致打包后的包体积增大。
当项目中使用了 moment.js 时，推荐开启此选项，自动排除所有的语言包文件：
export default {
@@ -487,8 +487,8 @@ 默认值： true
打包工具： 仅支持 webpack
-是否模块化 lodash 的导入，删除未使用的 lodash 模块，从而减少 lodash 代码体积。
-这项优化基于 babel-plugin-lodash 和 swc-plugin-lodash 实现。
+是否模块化 lodash 的导入，删除未使用的 lodash 模块，从而减少 lodash 代码体积。
+这项优化基于 babel-plugin-lodash 和 swc-plugin-lodash 实现。
示例
该选项默认开启，Builder 会自动将 lodash 的代码引用指向子路径。
比如：
diff --git a/modern-js/builder/api/config-security.html b/modern-js/builder/api/config-security.html
index da2f1ef34e..dac6257fc5 100644
--- a/modern-js/builder/api/config-security.html
+++ b/modern-js/builder/api/config-security.html
@@ -1,4 +1,4 @@
-Security Config - Modern.js Builder
+Security Config - Modern.js Builder
-Modern.js BuilderSecurity Config
+
Modern.js BuilderSecurity Config
本章节描述了 Builder 中与安全有关的配置。
security.sri
@@ -26,11 +26,11 @@ secu
- 打包工具：
仅支持 webpack
为 HTML 所引入的子资源添加完整性属性 —— integrity，使浏览器能够验证引入资源的完整性，以此防止下载的资源被篡改。
-
启动该选项后会将 webpack 的 output.crossOriginLoading 配置项设置为 anonymous。
+
启动该选项后会将 webpack 的 output.crossOriginLoading 配置项设置为 anonymous。
SRI 介绍
子资源完整性 Subresource Integrity（SRI）是专门用来校验资源的一种方案，它读取资源标签中的 integrity 属性，将其中的信息摘要值，和资源实际的信息摘要值进行对比，如果发现无法匹配，那么浏览器就会拒绝执行资源。
对于 script 标签来说，结果为拒绝执行其中的代码；对于 CSS link 来说，结果为不加载其中的样式。
-
关于 SRI 的更多内容，可以查看 Subresource Integrity - MDN。
+
关于 SRI 的更多内容，可以查看 Subresource Integrity - MDN。
示例
默认情况下，不会开启 SRI，当开启之后它的默认配置如下：
{
@@ -102,7 +102,7 @@ checkSy
类型： string[]
默认值： 当前项目的 browserslist 配置
-targets 表示项目的目标浏览器范围，它的值为标准的 browserslist 数组，如果你不了解 browserslist 的用法，请参考 「设置浏览器范围」。
+targets 表示项目的目标浏览器范围，它的值为标准的 browserslist 数组，如果你不了解 browserslist 的用法，请参考 「设置浏览器范围」。
Builder 会读取 targets 的值，并自动推导出构建产物中可以使用的最低 ECMAScript 语法版本，比如 ES5 或 ES6。
- 示例：
diff --git a/modern-js/builder/api/config-source.html b/modern-js/builder/api/config-source.html
index f264936199..730252b285 100644
--- a/modern-js/builder/api/config-source.html
+++ b/modern-js/builder/api/config-source.html
@@ -1,4 +1,4 @@
-Source Config - Modern.js Builder
+Source Config - Modern.js Builder
-Modern.js BuilderSource Config
+
Modern.js BuilderSource Config
本章节描述了 Builder 中与源代码解析、编译方式相关的配置。
source.alias
- 类型：
Record<string, string | string[]> | Function
- 默认值：
undefined
-
设置文件引用的别名，对应 webpack 和 Rspack 的 resolve.alias 配置。
-
TIP
对于 TypeScript 项目，你只需要在 tsconfig.json 中配置 compilerOptions.paths 即可，Builder 会自动识别它，不需要额外配置 source.alias 字段，详见 「路径别名」。
+
设置文件引用的别名，对应 webpack 和 Rspack 的 resolve.alias 配置。
+
Object 类型
alias 的值可以定义为 Object 类型，其中的相对路径会自动被 Builder 转换为绝对路径。
@@ -166,7 +166,7 @@
prefer-al
};
source.include
const defaultInclude = [
@@ -177,7 +177,7 @@ so
];
source.include 用于指定额外需要编译的 JavaScript 文件。
为了避免二次编译，默认情况下，Rsbuild 只会编译当前目录下的 JavaScript 文件，以及所有目录下的 TypeScript 和 JSX 文件，不会编译 node_modules 下的 JavaScript 文件。
-
通过 source.include 配置项，可以指定需要 Rsbuild 额外进行编译的目录或模块。source.include 的用法与 Rspack 中的 Rule.include 一致，支持传入字符串、正则表达式来匹配模块的路径。
+
通过 source.include 配置项，可以指定需要 Rsbuild 额外进行编译的目录或模块。source.include 的用法与 Rspack 中的 Rule.include 一致，支持传入字符串、正则表达式来匹配模块的路径。
比如:
import path from 'path';
@@ -245,11 +245,11 @@ },
},
};
-
将 sourceType 设置为 unambiguous 可能会产生一些其他影响，请参考 Babel 官方文档。
+
将 sourceType 设置为 unambiguous 可能会产生一些其他影响，请参考 Babel 官方文档。
匹配 Symlink
如果你匹配的模块是通过 symlink 链接到当前项目中的，那么需要匹配这个模块的真实路径，而不是 symlink 后的路径。
比如，你将 Monorepo 中的 packages/foo 路径 symlink 到当前项目的 node_modules/foo 路径下，则需要去匹配 packages/foo 路径，而不是 node_modules/foo 路径。
-
该行为可以通过 webpack 的 resolve.symlinks 配置项来进行控制。
+
该行为可以通过 webpack 的 resolve.symlinks 配置项来进行控制。
注意事项
注意，source.include 不应该被用于编译整个 node_modules 目录，比如下面的写法是错误的：
export default {
@@ -263,7 +263,7 @@ so
- 类型：
Array<string | RegExp>
- 默认值：
[]
-指定不需要编译的 JavaScript/TypeScript 文件。用法与 webpack 中的 Rule.exclude 一致，支持传入字符串或正则表达式来匹配模块的路径。
+指定不需要编译的 JavaScript/TypeScript 文件。用法与 webpack 中的 Rule.exclude 一致，支持传入字符串或正则表达式来匹配模块的路径。
比如:
import path from 'path';
@@ -285,8 +285,8 @@ sou
- 嵌套对象的父子键名之间会用
. 连接作为需要替换的变量名。
- 以 typeof 开头的键名会用来替换 typeof 调用。
-更多细节参考 webpack - DefinePlugin。
-TIP
在使用 Rspack 作为打包工具时，支持的类型可参考 Rspack.builtins.define
+
更多细节参考 webpack - DefinePlugin。
+
示例
export default {
@@ -419,8 +419,8 @@ Func
},
};
source.transformImport
-
用于按需引入组件库的代码和样式，能力等价于 babel-plugin-import。
-
它与 babel-plugin-import 的区别在于，source.transformImport 不与 Babel 耦合。Builder 会自动识别当前使用的编译工具是 Babel、SWC 还是 Rspack，并添加相应的按需引入配置。
+
用于按需引入组件库的代码和样式，能力等价于 babel-plugin-import。
+
它与 babel-plugin-import 的区别在于，source.transformImport 不与 Babel 耦合。Builder 会自动识别当前使用的编译工具是 Babel、SWC 还是 Rspack，并添加相应的按需引入配置。
@@ -439,13 +439,13 @@
- 默认值：
-
当项目中安装了 Ant Design 组件库 <= 4.x 版本时，Builder 会自动添加以下默认配置：
+
当项目中安装了 Ant Design 组件库 <= 4.x 版本时，Builder 会自动添加以下默认配置：
const defaultAntdConfig = {
libraryName: 'antd',
libraryDirectory: isServer ? 'lib' : 'es',
style: true,
};
-
当项目中安装了 Arco Design 组件库 时，Builder 会自动添加以下默认配置：
+
当项目中安装了 Arco Design 组件库 时，Builder 会自动添加以下默认配置：
const defaultArcoConfig = [
{
libraryName: '@arco-design/web-react',
@@ -564,7 +564,7 @@ customName
自定义转换后的导入路径，输入是引入的成员，例如配置成 (member) => `my-lib/${member}` ，会将 import { foo } from 'bar' 转换成 import foo from 'my-lib/foo'。
-
在使用 Rspack 构建时，不能使用函数配置，但可以使用 handlebars 模版字符串，对于上面的函数配置，在使用模版字符串时可以用以下模版代替 my-lib/{{ member }}，也可以使用一些内置帮助方法，例如 my-lib/{{ kebabCase member }} 来转换成 kebab-case 格式，除了 kebabCase 以外还有 camelCase，snakeCase，upperCase，lowerCase 可以使用。
+
在使用 Rspack 构建时，不能使用函数配置，但可以使用 handlebars 模版字符串，对于上面的函数配置，在使用模版字符串时可以用以下模版代替 my-lib/{{ member }}，也可以使用一些内置帮助方法，例如 my-lib/{{ kebabCase member }} 来转换成 kebab-case 格式，除了 kebabCase 以外还有 camelCase，snakeCase，upperCase，lowerCase 可以使用。
customStyleName
- 类型：
((member: string) => string | undefined) | string
@@ -577,7 +577,7 @@ customStyl
自定义转换后的样式导入路径，输入是引入的成员，例如配置成 (member) => `my-lib/${member}` ，会将 import { foo } from 'bar' 转换成 import foo from 'my-lib/foo'。
-
在使用 Rspack 构建时，不能使用函数配置，但可以使用 handlebars 模版字符串，对于上面的函数配置，在使用模版字符串时可以用以下模版代替 my-lib/{{ member }}，也可以使用一些内置帮助方法，例如 my-lib/{{ kebabCase member }} 来转换成 kebab-case 格式，除了 kebabCase 以外还有 camelCase，snakeCase，upperCase，lowerCase 可以使用。
+
在使用 Rspack 构建时，不能使用函数配置，但可以使用 handlebars 模版字符串，对于上面的函数配置，在使用模版字符串时可以用以下模版代替 my-lib/{{ member }}，也可以使用一些内置帮助方法，例如 my-lib/{{ kebabCase member }} 来转换成 kebab-case 格式，除了 kebabCase 以外还有 camelCase，snakeCase，upperCase，lowerCase 可以使用。
source.preEntry
- 类型：
string | string[]
@@ -613,7 +613,7 @@ 类型： string | Record<BuilderTarget, string>
- 默认值：
undefined
-
用于为 resolve.extensions 添加统一的前缀。
+
用于为 resolve.extensions 添加统一的前缀。
如果多个文件拥有相同的名称，但具有不同的文件后缀，Builder 会根据 extensions 数组的顺序进行识别，解析数组中第一个被识别的文件，并跳过其余文件。
示例
下面是配置 .web 前缀的例子。
@@ -653,7 +653,7 @@
- 默认值：
undefined
-
该配置项将决定你使用 package.json 哪个字段导入 npm 模块。对应 webpack 的 resolve.mainFields 配置。
+
该配置项将决定你使用 package.json 哪个字段导入 npm 模块。对应 webpack 的 resolve.mainFields 配置。
示例
export default {
source: {
diff --git a/modern-js/builder/api/config-tools.html b/modern-js/builder/api/config-tools.html
index d87f869456..0d323a3e44 100644
--- a/modern-js/builder/api/config-tools.html
+++ b/modern-js/builder/api/config-tools.html
@@ -1,4 +1,4 @@
-Tools Config - Modern.js Builder
+Tools Config - Modern.js Builder
-Modern.js BuilderTools Config
+
Modern.js Builder