命令行界面

命令必须显式给出。不带命令运行 rselectron 时，会向 stderr 打印帮助并以状态码 1 退出，不会启动 Electron。长旗标仅使用 kebab-case — 没有 camel-case 别名，也没有隐式默认命令。

失败使用带稳定 code 的 RselectronError；CLI 打印消息（以及存在时的 hint）并以非零退出。

`rselectron dev`

构建主进程与预加载脚本，为渲染进程启动开发服务器，并启动 Electron 应用。

构建已配置的主进程、预加载脚本与渲染进程源码。通常在打包 Electron 应用之前执行。

build 是一次性的，不支持 watch。传入 --watch 会抛出 RSELECTRON_BUILD_WATCH_UNSUPPORTED。主进程 / 预加载热重载请用 rselectron dev --watch。

构建主进程、预加载脚本与渲染进程（可用 --skip-build 跳过），并启动 Electron 进行预览。

打印规范化后的配置，不构建也不启动。默认输出 JSON；可用 --format human 查看可读文本。输出含每个进程的规范化 Rselectron 配置、最终 Rsbuild 配置与最终 Rspack 配置，并对敏感环境派生值脱敏。

选项	描述
`--config <path>`	指定配置文件路径
`--config-loader <auto\|jiti\|native>`	选择配置加载器
`--mode <development\|production\|none>`	设置构建模式
`--env-mode <name>`	选择环境文件命名空间
`-v, --version`	显示版本号
`-h, --help`	显示帮助

--mode 与 --env-mode 相互独立 — 见环境。

选项	描述
`--watch` / `--watch=main` / `--watch=preload`	让主进程和/或预加载参与重建；覆盖配置里的 `electron.watch`
`--renderer-only`	只启动渲染进程开发服务器，复用已有的主进程 / 预加载产物

Note

--renderer-only 会跳过主进程与预加载构建。请先至少完整跑过一次 rselectron dev（或 build），且在改动主进程 / 预加载源码后不要继续用该旗标。

当被监视的配置依赖变化时，Rselectron 会重新加载配置并替换整个开发会话。

选项	描述
`--skip-build`	跳过构建，直接启动预览

选项	描述
`--format <json\|human>`	输出格式（默认 `json`）