Skip to content

Commit 053a3e4

Browse files
waynzhwaynzh
authored
Merge pull request #1171 from vitejs/batch-1
docs(cn): fix build errors
2 parents 6a8a2ce + 950968a commit 053a3e4

File tree

4 files changed

+76
-76
lines changed

4 files changed

+76
-76
lines changed

‎config/index.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,10 +22,10 @@ export default {
2222
vite --config my-config.js
2323
```
2424

25-
::: tip 配置文件的打包
26-
默认情况下，Vite 使用 `esbuild` 将配置捆绑到临时文件中并加载它。这可能会在 monorepo 中导入 TypeScript 文件时导致问题。如果您在使用此方法时遇到任何问题，您可以指定 `--configLoader runner` 以改用 [module runner](/guide/api-environment-runtimes.html#modulerunner)，它不会创建临时配置并将动态转换任何文件。请注意，module runner 不支持配置文件中的 CJS，但外部 CJS 包应该可以正常工作。
25+
::: tip 加载配置文件
26+
默认情况下，Vite 使用 `esbuild` 将配置文件打包到临时文件中并加载它。这可能会在 monorepo 中导入 TypeScript 文件时引发问题。如果你遇到了这种方法问题，可以通过指定 `--configLoader runner` 以改用 [module runner](/guide/api-environment-runtimes.html#modulerunner)，它不会创建临时配置并将动态转换任何文件。请注意，module runner 不支持配置文件中的 CJS，但外部 CJS 包应该可以正常工作。
2727

28-
或者，如果您使用支持 TypeScript 的环境（例如 `node --experimental-strip-types`），或者您只编写纯 JavaScript，您可以指定 `--configLoader native` 以使用环境的本机运行时加载配置文件。请注意，配置文件导入的模块的更新不会被检测到，因此不会自动重启 Vite 服务器。
28+
另外，如果你正在使用支持TypeScript的环境（例如 `node --experimental-strip-types`），或者只编写纯 JavaScript 代码，你可以指定 `--configLoader native` 以使用环境的本机运行时加载配置文件。请注意，配置文件导入的模块的更新不会被检测到，因此不会自动重启 Vite 服务器。
2929
:::
3030

3131
## 配置智能提示 {#config-intellisense}

‎guide/build.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -276,7 +276,7 @@ dist/my-lib.umd.cjs 0.30 kB / gzip: 0.16 kB
276276
277277
### CSS 支持 {#css-support}
278278
279-
如果您的库导入了 CSS，除了内置的 JS 文件外，它还将作为一个 CSS 文件捆绑在一起，例如 `dist/my-lib.css`。文件名默认为 `build.lib.fileName`，但也可以使用 [`build.lib.cssFileName`](/config/build-options.md#build-lib)进行更改。
279+
如果您的库导入了 CSS，除了内置的 JS 文件外，它还将作为一个 CSS 文件打包在一起，例如 `dist/my-lib.css`。文件名默认为 `build.lib.fileName`，但也可以使用 [`build.lib.cssFileName`](/config/build-options.md#build-lib)进行更改。
280280
281281
您可以在 `package.json` 中导出 CSS 文件，以便用户导入：
282282

‎guide/cli.md‎

Lines changed: 69 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -14,25 +14,25 @@ vite [root]
1414

1515
#### 选项 {#options}
1616

17-
| 选项 | |
18-
| ------------------------ | -------------------------------------------------------------------------------------- |
19-
| `--host [host]` | 指定主机名称 (`string`) |
20-
| `--port <port>` | 指定端口 (`number`) |
21-
| `--open [path]` | 启动时打开浏览器 (`boolean \| string`) |
22-
| `--cors` | 启用 CORS (`boolean`) |
23-
| `--strictPort` | 如果指定的端口已在使用中，则退出 (`boolean`) |
24-
| `--force` | 强制优化器忽略缓存并重新构建 (`boolean`) |
25-
| `-c, --config <file>` | 使用指定的配置文件 (`string`) |
26-
| `--base <path>` | 公共基础路径（默认为：`/`）(`string`) |
27-
| `-l, --logLevel <level>` | info \| warn \| error \| silent (`string`) |
28-
| `--clearScreen` | 允许或禁用打印日志时清除屏幕 (`boolean`) |
17+
| 选项 | |
18+
| ------------------------- | --------------------------------------------------------------------------------------------- |
19+
| `--host [host]` | 指定主机名称 (`string`) |
20+
| `--port <port>` | 指定端口 (`number`) |
21+
| `--open [path]` | 启动时打开浏览器 (`boolean \| string`) |
22+
| `--cors` | 启用 CORS (`boolean`) |
23+
| `--strictPort` | 如果指定的端口已在使用中，则退出 (`boolean`) |
24+
| `--force` | 强制优化器忽略缓存并重新构建 (`boolean`) |
25+
| `-c, --config <file>` | 使用指定的配置文件 (`string`) |
26+
| `--base <path>` | 公共基础路径（默认为：`/`）(`string`) |
27+
| `-l, --logLevel <level>` | info \| warn \| error \| silent (`string`) |
28+
| `--clearScreen` | 允许或禁用打印日志时清除屏幕 (`boolean`) |
2929
| `--configLoader <loader>` | 使用 `bundle` 来采用 esbuild 打包配置，或是 `runner`（实验性）来在运行时处理，默认是 `bundle` |
30-
| `--profile` | 启动内置的 Node.js 调试器（查看 [性能瓶颈](/guide/troubleshooting#performance-bottlenecks)）|
31-
| `-d, --debug [feat]` | 显示调试日志 (`string \| boolean`) |
32-
| `-f, --filter <filter>` | 过滤调试日志 (`string`) |
33-
| `-m, --mode <mode>` | 设置环境模式 (`string`) |
34-
| `-h, --help` | 显示可用的 CLI 选项 |
35-
| `-v, --version` | 显示版本号 |
30+
| `--profile` | 启动内置的 Node.js 调试器（查看 [性能瓶颈](/guide/troubleshooting#performance-bottlenecks)） |
31+
| `-d, --debug [feat]` | 显示调试日志 (`string \| boolean`) |
32+
| `-f, --filter <filter>` | 过滤调试日志 (`string`) |
33+
| `-m, --mode <mode>` | 设置环境模式 (`string`) |
34+
| `-h, --help` | 显示可用的 CLI 选项 |
35+
| `-v, --version` | 显示版本号 |
3636

3737
## 构建 {#build}
3838

@@ -48,38 +48,38 @@ vite build [root]
4848

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

51-
| 选项 | |
52-
| ------------------------------ | -------------------------------------------------------------------------------------------- |
53-
| `--target <target>` | 编译目标（默认为：`"modules"`）(`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]` | 允许或禁用最小化混淆，或指定使用哪种混淆器（默认为：`"esbuild"`）(`boolean \| "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` 来采用 esbuild 打包配置，或是 `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`，实验性）|
51+
| 选项 | |
52+
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
53+
| `--target <target>` | 编译目标（默认为：`"modules"`）(`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]` | 允许或禁用最小化混淆，或指定使用哪种混淆器（默认为：`"esbuild"`）(`boolean \| "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` 来采用 esbuild 打包配置，或是 `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

7878
### `vite optimize` {#vite-optimize}
7979

8080
预构建依赖。
8181

82-
**Deprecated**: 预捆绑过程自动运行，不需要调用。
82+
**Deprecated**: 预构建过程自动运行，不需要调用。
8383

8484
#### 使用 {#usage-2}
8585

@@ -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`) |
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`) |
9999
| `--configLoader <loader>` | 使用 `bundle` 来采用 esbuild 打包配置，或是 `runner`（实验性）来在运行时处理，默认是 `bundle` |
100-
| `-d, --debug [feat]` | 显示调试日志 (`string \| boolean`) |
101-
| `-f, --filter <filter>` | 过滤调试日志 (`string`) |
102-
| `-m, --mode <mode>` | 设置环境模式 (`string`) |
103-
| `-h, --help` | 显示可用的 CLI 选项 |
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

@@ -114,19 +114,19 @@ vite preview [root]
114114

115115
#### 选项 {#options-3}
116116

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

0 commit comments

Comments
 (0)