> For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt.
# 命令行工具
Rsbuild 内置了一个轻量的命令行工具，包含 [rsbuild dev](#rsbuild)、[rsbuild build](#rsbuild-build) 等命令。
## 查看所有命令
如果你需要查看所有可用的 CLI 命令，请在项目目录中运行以下命令：
```bash
npx rsbuild -h
```
输出如下：
```
Usage:
$ rsbuild [command] [options]
Commands:
dev Start the dev server
build Build the app for production
preview Preview the production build locally
inspect Inspect the Rspack and Rsbuild configs
```
## 公共选项
Rsbuild CLI 提供了一些公共选项，可以用于所有命令：
| 选项 | 描述 |
| -------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `--base ` | 指定服务端的基础路径，详见 [server.base](/zh/config/server/base.md) |
| `-c, --config ` | 指定配置文件路径（相对路径或绝对路径），详见 [指定配置文件](/zh/guide/configuration/rsbuild.md#specify-config-file) |
| `--config-loader ` | 指定配置文件加载方式（`auto` \| `jiti` \| `native`），详见 [指定加载方式](/zh/guide/configuration/rsbuild.md#specify-config-loader) |
| `--dist-path ` | 指定构建产物的根目录，详见 [output.distPath](/zh/config/output/dist-path.md) |
| `--env-mode ` | 指定 env 模式来加载 `.env.[mode]` 文件，详见 [Env 模式](/zh/guide/advanced/env-vars.md#env-mode) |
| `--env-dir ` | 指定目录来加载 `.env` 文件，详见 [Env 目录](/zh/guide/advanced/env-vars.md#env-directory) |
| `--environment ` | 指定需要构建的 environment 名称，详见 [构建指定环境](/zh/guide/advanced/environments.md#build-a-specific-environment) |
| `-h, --help` | 显示命令帮助 |
| `--log-level ` | 指定日志级别（`info` \| `warn` \| `error` \| `silent`），详见 [logLevel](/zh/config/log-level.md) |
| `-m, --mode ` | 指定构建模式（`development` \| `production` \| `none`），详见 [mode](/zh/config/mode.md) |
| `--no-env` | 禁用 `.env` 文件的加载 |
| `--no-source-map` | 禁用 source map，详见 [output.sourceMap](/zh/config/output/source-map.md) |
| `-r, --root ` | 指定项目根目录（绝对路径或者相对于 [cwd](https://nodejs.org/api/process.html#processcwd) 的路径） |
| `--source-map` | 启用 source map，详见 [output.sourceMap](/zh/config/output/source-map.md) |
对于布尔类型的选项，可以使用 `--no-` 前缀来显式禁用对应功能，例如 `--no-env` 或 `--no-source-map`。
## rsbuild
`rsbuild` 命令用于启动本地开发服务器，并以开发模式编译源代码。`rsbuild dev` 是 `rsbuild` 的别名。
```bash
Usage:
rsbuild [options]
rsbuild dev [options]
Options:
-o, --open [url] 启动时是否在浏览器中打开页面
--port 设置 Rsbuild server 监听的端口号
--strict-port 当指定端口已被占用时退出
--host [host] 指定 Rsbuild server 启动时监听的 host
```
### 指定 Host \{#specifying-host}
默认情况下，dev server 仅监听 `localhost`。当传入 `--host` 且未指定值时，服务器会监听所有网络接口：
```bash
npx rsbuild --host
# 等同于：
npx rsbuild --host 0.0.0.0
```
### 打开页面 \{#opening-page}
通过 `--open` 选项可以在启动 dev server 时自动打开页面，等同于将 [server.open](/zh/config/server/open.md) 设置为 `true`。
```bash
rsbuild --open
```
`--open` 选项也支持指定需要打开的 URL 地址，比如：
```bash
rsbuild --open http://localhost:3000/foo
```
`--open` 选项也可以缩写为 `-o`：
```bash
rsbuild -o
```
:::tip
当同时使用 [server.open](/zh/config/server/open.md) 和 `--open` 时，`--open` 的优先级更高。
:::
## rsbuild build
`rsbuild build` 命令默认会在 `dist/` 目录下构建出可用于生产环境的产物。
```bash
Usage: rsbuild build [options]
Options:
-w, --watch 启用监视模式，在文件更改时自动重新构建
```
## rsbuild preview
`rsbuild preview` 命令用于在本地预览生产模式构建的产物, 注意你需要提前执行 `rsbuild build` 命令构建出对应产物。
```bash
Usage: rsbuild preview [options]
Options:
-o, --open [url] 启动时是否在浏览器中打开页面
--port 设置 Rsbuild server 监听的端口号
--strict-port 当指定端口已被占用时退出
--host [host] 指定 Rsbuild server 启动时监听的 host
```
:::tip
preview 命令仅用于本地预览，请勿将它用于生产服务器，因为它不是为此而设计的。
:::
## rsbuild inspect
`rsbuild inspect` 命令用于查看项目的 Rsbuild 配置以及 Rspack 配置。
```bash
Usage: rsbuild inspect [options]
Options:
--output