Skip to content

docs(cn): fix build errors #1171

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Feb 10, 2025
Merged

docs(cn): fix build errors #1171

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions config/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,10 +22,10 @@ export default {
vite --config my-config.js
```

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

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

## 配置智能提示 {#config-intellisense}
Expand Down
2 changes: 1 addition & 1 deletion guide/build.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -276,7 +276,7 @@ dist/my-lib.umd.cjs 0.30 kB / gzip: 0.16 kB

### CSS 支持 {#css-support}

如果您的库导入了 CSS，除了内置的 JS 文件外，它还将作为一个 CSS 文件捆绑在一起，例如 `dist/my-lib.css`。文件名默认为 `build.lib.fileName`，但也可以使用 [`build.lib.cssFileName`](/config/build-options.md#build-lib)进行更改。
如果您的库导入了 CSS，除了内置的 JS 文件外，它还将作为一个 CSS 文件打包在一起，例如 `dist/my-lib.css`。文件名默认为 `build.lib.fileName`，但也可以使用 [`build.lib.cssFileName`](/config/build-options.md#build-lib)进行更改。

您可以在 `package.json` 中导出 CSS 文件，以便用户导入：

Expand Down
138 changes: 69 additions & 69 deletions guide/cli.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,25 +14,25 @@ vite [root]

#### 选项 {#options}

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

## 构建 {#build}

Expand All @@ -48,38 +48,38 @@ vite build [root]

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

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

## 其他 {#others}

### `vite optimize` {#vite-optimize}

预构建依赖。

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

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

Expand All @@ -89,18 +89,18 @@ vite optimize [root]

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

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

### `vite preview` {#vite-preview}

Expand All @@ -114,19 +114,19 @@ vite preview [root]

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

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