Skip to content

Commit 38d88dc

Browse files
waynzhwaynzh
authored
Merge pull request #1616 from vitejs/sync-b187d63a-1
docs(en): merge docs-cn/sync-docs into docs-cn/dev @ b187d63
2 parents ec834fa + 0ea4791 commit 38d88dc

4 files changed

Lines changed: 181 additions & 154 deletions

File tree

‎guide/api-javascript.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -310,6 +310,8 @@ function mergeConfig(
310310

311311
深度合并两份配置。`isRoot` 代表着 Vite 配置被合并的层级。举个例子，如果你是要合并两个 `build` 选项请设为 `false`。
312312

313+
请注意，`overrides` 中值为 `null` 和 `undefined` 的属性会被跳过，不参与合并。如果你需要显式清除 `defaults` 中的某个值，请直接修改 `mergeConfig` 的返回结果。
314+
313315
::: tip NOTE
314316
`mergeConfig` 只接受对象形式的配置。如果有一个回调形式的配置，应该在将其传递给 `mergeConfig` 之前先调用该回调函数，将其转换成对象形式。
315317

‎guide/cli.md‎

Lines changed: 52 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -48,30 +48,30 @@ vite build [root]
4848

4949
#### 选项 {#options-1}
5050

51-
| 选项 | |
52-
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
53-
| `--target <target>` | 编译目标（默认为：`"baseline-widely-available"`）(`string`) |
54-
| `--outDir <dir>` | 输出目录（默认为：`dist`）(`string`) |
55-
| `--assetsDir <dir>` | 在输出目录下放置资源的目录（默认为：`"assets"`）(`string`) |
56-
| `--assetsInlineLimit <number>` | 静态资源内联为 base64 编码的阈值，以字节为单位（默认为：`4096`）(`number`) |
57-
| `--ssr [entry]` | 为服务端渲染配置指定入口文件 (`string`) |
58-
| `--sourcemap [output]` | 构建后输出 source map 文件（默认为：`false`）(`boolean \| "inline" \| "hidden"`) |
59-
| `--minify [minifier]` | 允许或禁用最小化混淆，或指定使用哪种混淆器（默认为：`"oxc"`）(`boolean \| "oxc" \| "terser" \| "esbuild"`) |
60-
| `--manifest [name]` | 构建后生成 manifest.json 文件 (`boolean \| string`) |
61-
| `--ssrManifest [name]` | 构建后生成 SSR manifest.json 文件 (`boolean \| string`) |
62-
| `--emptyOutDir` | 若输出目录在根目录外，强制清空输出目录 (`boolean`) |
63-
| `-w, --watch` | 在磁盘中模块发生变化时，重新构建 (`boolean`) |
64-
| `-c, --config <file>` | 使用指定的配置文件 (`string`) |
65-
| `--base <path>` | 公共基础路径（默认为：`/`）(`string`) |
66-
| `-l, --logLevel <level>` | Info \| warn \| error \| silent (`string`) |
67-
| `--clearScreen` | 允许或禁用打印日志时清除屏幕 (`boolean`) |
68-
| `--configLoader <loader>` | 使用 `bundle` 来采用 Rolldown 打包配置，或是 `runner`（实验性）来在运行时处理，默认是 `bundle` |
69-
| `--profile` | 启动内置的 Node.js 调试器（查看 [性能瓶颈](/guide/troubleshooting#performance-bottlenecks)） |
70-
| `-d, --debug [feat]` | 显示调试日志 (`string \| boolean`) |
71-
| `-f, --filter <filter>` | 过滤调试日志 (`string`) |
72-
| `-m, --mode <mode>` | 设置环境模式 (`string`) |
73-
| `-h, --help` | 显示可用的 CLI 选项 |
74-
| `--app` | 构建所有环境，这与 `builder: {}` 是一样的（`boolean`，实验性） |
51+
| 选项 | |
52+
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
53+
| `--target <target>` | 编译目标（默认为：`"baseline-widely-available"`）(`string`) |
54+
| `--outDir <dir>` | 输出目录（默认为：`dist`）(`string`) |
55+
| `--assetsDir <dir>` | 在输出目录下放置资源的目录（默认为：`"assets"`）(`string`) |
56+
| `--assetsInlineLimit <number>` | 静态资源内联为 base64 编码的阈值，以字节为单位（默认为：`4096`）(`number`) |
57+
| `--ssr [entry]` | 为服务端渲染配置指定入口文件 (`string`) |
58+
| `--sourcemap [output]` | 构建后输出 source map 文件（默认为：`false`）(`boolean \| "inline" \| "hidden"`) |
59+
| `--minify [minifier]` | 允许或禁用最小化混淆，或指定使用哪种混淆器（默认为：`"oxc"`）(`boolean \| "oxc" \| "terser" \| "esbuild"`) |
60+
| `--manifest [name]` | 构建后生成 manifest.json 文件 (`boolean \| string`) |
61+
| `--ssrManifest [name]` | 构建后生成 SSR manifest.json 文件 (`boolean \| string`) |
62+
| `--emptyOutDir` | 若输出目录在根目录外，强制清空输出目录 (`boolean`) |
63+
| `-w, --watch` | 在磁盘中模块发生变化时，重新构建 (`boolean`) |
64+
| `-c, --config <file>` | 使用指定的配置文件 (`string`) |
65+
| `--base <path>` | 公共基础路径（默认为：`/`）(`string`) |
66+
| `-l, --logLevel <level>` | Info \| warn \| error \| silent (`string`) |
67+
| `--clearScreen` | 允许或禁用打印日志时清除屏幕 (`boolean`) |
68+
| `--configLoader <loader>` | 使用 `bundle` 来采用 Rolldown 打包配置，或是 `runner`（实验性）来在运行时处理，或是 `native`（实验性）来使用原生运行时加载，默认是 `bundle` |
69+
| `--profile` | 启动内置的 Node.js 调试器（查看 [性能瓶颈](/guide/troubleshooting#performance-bottlenecks)） |
70+
| `-d, --debug [feat]` | 显示调试日志 (`string \| boolean`) |
71+
| `-f, --filter <filter>` | 过滤调试日志 (`string`) |
72+
| `-m, --mode <mode>` | 设置环境模式 (`string`) |
73+
| `-h, --help` | 显示可用的 CLI 选项 |
74+
| `--app` | 构建所有环境，这与 `builder: {}` 是一样的（`boolean`，实验性） |
7575

7676
## 其他 {#others}
7777

@@ -89,18 +89,18 @@ vite optimize [root]
8989

9090
#### 选项 {#options-2}
9191

92-
| 选项 | |
93-
| ------------------------- | --------------------------------------------------------------------------------------------- |
94-
| `--force` | 强制优化器忽略缓存并重新构建 (`boolean`) |
95-
| `-c, --config <file>` | 使用指定的配置文件 (`string`) |
96-
| `--base <path>` | 公共基础路径（默认为：`/`）(`string`) |
97-
| `-l, --logLevel <level>` | Info \| warn \| error \| silent (`string`) |
98-
| `--clearScreen` | 允许或禁用打印日志时清除屏幕 (`boolean`) |
99-
| `--configLoader <loader>` | 使用 `bundle` 来采用 Rolldown 打包配置，或是 `runner`（实验性）来在运行时处理，默认是 `bundle` |
100-
| `-d, --debug [feat]` | 显示调试日志 (`string \| boolean`) |
101-
| `-f, --filter <filter>` | 过滤调试日志 (`string`) |
102-
| `-m, --mode <mode>` | 设置环境模式 (`string`) |
103-
| `-h, --help` | 显示可用的 CLI 选项 |
92+
| 选项 | |
93+
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
94+
| `--force` | 强制优化器忽略缓存并重新构建 (`boolean`) |
95+
| `-c, --config <file>` | 使用指定的配置文件 (`string`) |
96+
| `--base <path>` | 公共基础路径（默认为：`/`）(`string`) |
97+
| `-l, --logLevel <level>` | Info \| warn \| error \| silent (`string`) |
98+
| `--clearScreen` | 允许或禁用打印日志时清除屏幕 (`boolean`) |
99+
| `--configLoader <loader>` | 使用 `bundle` 来采用 Rolldown 打包配置，或是 `runner`（实验性）来在运行时处理，或是 `native`（实验性）来使用原生运行时加载，默认是 `bundle` |
100+
| `-d, --debug [feat]` | 显示调试日志 (`string \| boolean`) |
101+
| `-f, --filter <filter>` | 过滤调试日志 (`string`) |
102+
| `-m, --mode <mode>` | 设置环境模式 (`string`) |
103+
| `-h, --help` | 显示可用的 CLI 选项 |
104104

105105
### `vite preview` {#vite-preview}
106106

@@ -116,19 +116,19 @@ vite preview [root]
116116

117117
#### 选项 {#options-3}
118118

119-
| 选项 | |
120-
| ------------------------- | --------------------------------------------------------------------------------------------- |
121-
| `--host [host]` | 指定主机名称 (`string`) |
122-
| `--port <port>` | 指定端口 (`number`) |
123-
| `--strictPort` | 如果指定的端口已在使用中，则退出 (`boolean`) |
124-
| `--open [path]` | 启动时打开浏览器 (`boolean \| string`) |
125-
| `--outDir <dir>` | 输出目录（默认为：`dist`)(`string`) |
126-
| `-c, --config <file>` | 使用指定的配置文件 (`string`) |
127-
| `--base <path>` | 公共基础路径（默认为：`/`）(`string`) |
128-
| `-l, --logLevel <level>` | Info \| warn \| error \| silent (`string`) |
129-
| `--clearScreen` | 允许或禁用打印日志时清除屏幕 (`boolean`) |
130-
| `--configLoader <loader>` | 使用 `bundle` 来采用 Rolldown 打包配置，或是 `runner`（实验性）来在运行时处理，默认是 `bundle` |
131-
| `-d, --debug [feat]` | 显示调试日志 (`string \| boolean`) |
132-
| `-f, --filter <filter>` | 过滤调试日志 (`string`) |
133-
| `-m, --mode <mode>` | 设置环境模式 (`string`) |
134-
| `-h, --help` | 显示可用的 CLI 选项 |
119+
| 选项 | |
120+
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
121+
| `--host [host]` | 指定主机名称 (`string`) |
122+
| `--port <port>` | 指定端口 (`number`) |
123+
| `--strictPort` | 如果指定的端口已在使用中，则退出 (`boolean`) |
124+
| `--open [path]` | 启动时打开浏览器 (`boolean \| string`) |
125+
| `--outDir <dir>` | 输出目录（默认为：`dist`)(`string`) |
126+
| `-c, --config <file>` | 使用指定的配置文件 (`string`) |
127+
| `--base <path>` | 公共基础路径（默认为：`/`）(`string`) |
128+
| `-l, --logLevel <level>` | Info \| warn \| error \| silent (`string`) |
129+
| `--clearScreen` | 允许或禁用打印日志时清除屏幕 (`boolean`) |
130+
| `--configLoader <loader>` | 使用 `bundle` 来采用 Rolldown 打包配置，或是 `runner`（实验性）来在运行时处理，或是 `native`（实验性）来使用原生运行时加载，默认是 `bundle` |
131+
| `-d, --debug [feat]` | 显示调试日志 (`string \| boolean`) |
132+
| `-f, --filter <filter>` | 过滤调试日志 (`string`) |
133+
| `-m, --mode <mode>` | 设置环境模式 (`string`) |
134+
| `-h, --help` | 显示可用的 CLI 选项 |

‎package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@
2424
"vitepress": "2.0.0-alpha.17",
2525
"vitepress-plugin-graphviz": "^0.1.0",
2626
"vitepress-plugin-group-icons": "^1.7.5",
27-
"vue": "^3.5.32",
27+
"vue": "^3.5.33",
2828
"vue-tsc": "^3.2.7",
2929
"yorkie": "^2.0.0"
3030
},

0 commit comments

Comments
 (0)