Rsbuild 内置了一个轻量的命令行工具,包含 rsbuild dev、rsbuild build 等命令。
如果你需要查看所有可用的 CLI 命令,请在项目目录中运行以下命令:
输出如下:
Rsbuild CLI 提供了一些公共选项,可以用于所有命令:
| 选项 | 描述 |
|---|---|
--base <base> | 指定服务端的基础路径,详见 server.base |
-c, --config <config> | 指定配置文件路径(相对路径或绝对路径),详见 指定配置文件 |
--config-loader <loader> | 指定配置文件加载方式(auto | jiti | native),详见 指定加载方式 |
--env-mode <mode> | 指定 env 模式来加载 .env.[mode] 文件,详见 Env 模式 |
--env-dir <dir> | 指定目录来加载 .env 文件,详见 Env 目录 |
--environment <name> | 指定需要构建的 environment 名称,详见 构建指定环境 |
-h, --help | 显示命令帮助 |
--log-level <level> | 指定日志级别(info | warn | error | silent),详见 logLevel |
-m, --mode <mode> | 指定构建模式(development | production | none),详见 mode |
--no-env | 禁用 .env 文件的加载 |
-r, --root <root> | 指定项目根目录(绝对路径或者相对于 cwd 的路径) |
rsbuild dev 命令用于启动一个本地开发服务器,对源代码进行开发模式编译。
你也可以直接运行 rsbuild 来启动 dev server,等同于运行 rsbuild dev。
通过 --open 选项可以在启动 dev server 时自动打开页面,等同于将 server.open 设置为 true。
--open 选项也支持指定需要打开的 URL 地址,比如:
--open 选项也可以缩写为 -o:
当同时使用 server.open 和 --open 时,--open 的优先级更高。
rsbuild build 命令默认会在 dist/ 目录下构建出可用于生产环境的产物。
rsbuild preview 命令用于在本地预览生产模式构建的产物, 注意你需要提前执行 rsbuild build 命令构建出对应产物。
preview 命令仅用于本地预览,请勿将它用于生产服务器,因为它不是为此而设计的。
rsbuild inspect 命令用于查看项目的 Rsbuild 配置以及 Rspack 配置。
当你在项目根目录下执行命令 npx rsbuild inspect 后,会在项目的 dist/.rsbuild 目录生成以下文件:
rsbuild.config.mjs: 表示在构建时使用的 Rsbuild 配置。rspack.config.web.mjs: 表示在构建时使用的 Rspack 配置。默认情况下,inspect 命令会输出开发模式的配置,你可以添加 --mode production 选项来输出生产模式的配置:
默认情况下,inspect 命令会省略配置对象中的函数内容,你可以添加 --verbose 选项来输出函数的完整内容:
如果当前项目有多种产物类型,比如同时构建了浏览器产物和 Node.js 产物,那么会在 dist/.rsbuild 目录生成多份 Rspack 配置文件。