CLI

本页汇总 addfox CLI 支持的命令与参数。

基本用法

addfox <command> [options]

在 package.json 中配置 scripts

{
  "scripts": {
    "dev": "addfox dev",
    "dev:firefox": "addfox dev -b firefox",
    "build": "addfox build",
    "build:chrome": "addfox build -b chrome",
    "test": "addfox test"
  }
}

命令

命令说明
dev启动开发模式(支持热更新)。
build执行生产构建。
test运行测试(参数会透传给 rstest)。

常用参数(默认值 + 配置映射)

参数内置默认值对应 addfox.config 字段说明
-b, --browser <browser>chromium无直接字段(影响目标与启动)指定目标/启动浏览器,详见下方支持的浏览器列表
-c, --cachetruecache启用浏览器 profile 缓存。
--no-cachefalse(仅当前命令)cache禁用本次运行的浏览器 profile 缓存。
-r, --reportfalsereport启用 Rsdoctor 构建分析报告。
--no-openfalse(即默认自动打开)无直接字段构建或开发时不自动打开浏览器。
--debugfalsedebug启用调试模式(开发时错误监控等能力)。
--help--显示帮助。
--version--显示版本号。

支持的浏览器列表

-b, --browser 参数支持以下浏览器:

浏览器说明
chromiumChromium(默认)
chromeGoogle Chrome
edgeMicrosoft Edge
braveBrave Browser
vivaldiVivaldi
operaOpera
santaSanta Browser
arcArc Browser
yandexYandex Browser
browserosBrowserOS
custom自定义浏览器(需在配置中指定 browser.custom
firefoxMozilla Firefox

示例

# Chromium 开发模式
addfox dev -b chromium

# Firefox 开发 + 调试
addfox dev -b firefox --debug

# 生产构建
addfox build -b chrome

# 构建但不自动打开浏览器
addfox build -b chrome --no-open

# 生成构建分析报告
addfox build -r

说明

  • --debug 主要作用于 dev 模式。
  • --no-cache 适合做“干净环境”排查;cache 仍可在配置文件中作为项目默认值。
  • -b/--browser 没有单独的 config 字段,属于命令级选择。