命令行工具
@rspack/cli 是 Rspack 的命令行工具,它提供了多种命令来简化 Rspack 的使用。
和 webpack-cli 的兼容性
@rspack/cli
与 webpack-cli
并不是完全兼容的,它们会有一些使用方式的差异。
rspack build
rspack build
用于运行 Rspack 构建,将会在 output.path 目录下生成构建后的文件。
npx rspack build # 默认读取 `rspack.config.*` 配置文件
rspack build
可以缩写为 rspack b
:
使用 -c
或 --config
选项来指定配置文件路径:
npx rspack build -c ./your.config.js
完整的选项如下:
rspack build
Options:
--entry entry file [array]
-o, --output-path output path dir [string]
-m, --mode mode [string]
-w, --watch watch [boolean] [default: false]
--env env passed to config function [array]
--node-env sets process.env.NODE_ENV to be specified value [string]
-d, --devtool devtool [boolean] [default: false]
--configName Name of the configuration to use. [array]
--analyze analyze [boolean] [default: false]
--json emit stats json
--profile capture timing information for each module
[boolean] [default: false]
rspack dev
rspack dev
用于运行 Rspack 开发服务器,将会在本地启动一个开发服务器,监听文件变化并自动刷新浏览器。
使用 -c
或 --config
选项来指定配置文件路径:
npx rspack dev -c ./your.config.js
rspack dev
的别名为 rspack serve
或 rspack s
:
npx rspack s
npx rspack serve
完整的选项如下:
rspack dev
Options:
--entry entry file [array]
-o, --output-path output path dir [string]
-m, --mode mode [string]
-w, --watch watch [boolean] [default: false]
--env env passed to config function [array]
--node-env sets process.env.NODE_ENV to be specified value [string]
-d, --devtool devtool [boolean] [default: false]
--configName Name of the configuration to use. [array]
--hot enables hot module replacement
--port allows to specify a port to use [number]
--host allows to specify a hostname to use [string]
rspack preview
rspack preview
用于在本地预览生产模式构建的产物, 注意你需要提前执行 rspack build
命令构建出产物。
完整的选项如下:
rspack preview [dir]
Positionals:
dir directory want to preview [string]
Options:
--publicPath static resource server path [string]
--port preview server port [number]
--host preview server host [string]
--open open browser [boolean]
--server Configuration items for the server. [string]
--configName Name of the configuration to use. [array]
公共选项
下面是一些公共的选项,所有 Rspack 命令都支持这些选项:
选项 |
作用 |
-c, --config [value] |
指定配置文件路径 |
-h, --help |
显示帮助信息 |
-v, --version |
显示版本号 |