-r, --root <path> | 根路径 |
-c, --config <path> | 配置文件的路径 |
-u, --update | 更新快照 |
-w, --watch | 启用 watch 模式 |
-t, --testNamePattern <pattern> | 使用符合指定 regexp 模式的全名运行测试 |
--dir <path> | 扫描测试文件的基本目录 |
--ui | 启用用户界面 |
--open | 自动打开用户界面 (默认: !process.env.CI) |
--api.port [port] | 自动打开用户界面指定服务器端口。请注意，如果端口已被使用，Vite 会自动尝试下一个可用端口，因此这可能不是服务器最终监听的实际端口。如果为 "true"，将设置为 51204 |
--api.host [host] | 指定服务器应该监听哪些 IP 地址。设为 0.0.0.0 或 true 则监听所有地址，包括局域网地址和公共地址 |
--api.strictPort | 设置为 true 时，如果端口已被使用，则退出，而不是自动尝试下一个可用端口 |
--silent | 测试控制台输出 |
--hideSkippedTests | 隐藏跳过测试的日志 |
--reporter <name> | 指定报告 |
--outputFile <filename/-s> | 如果还指定了支持报告程序，则将测试结果写入文件，使用 cac 的点符号表示多个报告程序的单个输出结果 (比如: --outputFile.tap=./tap.txt) |
--coverage.all | 是否在报告中包含所有文件，包括未测试的文件 |
--coverage.provider <name> | 选择覆盖范围采集工具，可用值为 "V8"、"istanbul"和 "custom"。 |
--coverage.enabled | 启用覆盖范围收集。可使用 --coverage CLI 选项覆盖（默认值：false）。 |
--coverage.include <pattern> | 作为 glob 模式包含在覆盖范围内的文件。使用多个模式时，可指定多次（默认值：**）。 |
--coverage.exclude <pattern> | 覆盖范围中要排除的文件。使用多个扩展名时，可指定多次（默认情况下： 访问 coverage.exclude |
--coverage.extension <extension> | 包含在覆盖范围内的扩展名。使用多个扩展名时，可指定多次 (默认: [".js", ".cjs", ".mjs", ".ts", ".mts", ".cts", ".tsx", ".jsx", ".vue", ".svelte"]) |
--coverage.clean | 运行测试前清除覆盖结果（默认值：true） |
--coverage.cleanOnRerun | 重新运行监视时清理覆盖率报告（默认值：true） |
--coverage.reportsDirectory <path> | 将覆盖率报告写入的目录（默认值： ./coverage） |
--coverage.reporter <name> | 使用的报告。更多信息请访问 coverage.reporter。 (默认值: ["text", "html", "clover", "json"]) |
--coverage.reportOnFailure | 即使测试失败也能生成覆盖率报告 (默认值: false) |
--coverage.allowExternal | 收集项目根目录外文件的覆盖范围（默认值：false） |
--coverage.skipFull | 不显示语句、分支和函数覆盖率为 100% 的文件（默认值：false） |
--coverage.thresholds.100 | 将所有覆盖率阈值设置为 100 的快捷方式（默认值：false） |
--coverage.thresholds.perFile | 检查每个文件的阈值。 --coverage.thresholds.lines, --coverage.thresholds.functions, --coverage.thresholds.branches, --coverage.thresholds.statements 为实际阈值（默认值：false） |
--coverage.thresholds.autoUpdate | 更新阈值： 当当前覆盖率高于配置的阈值时，将 "lines"、"functions"、"branches"和 "statements"更新到配置文件（默认值：false） |
--coverage.thresholds.lines <number> | 针对代码行的覆盖度阈值设定，请访问 istanbuljs 了解更多信息。此选项不适用于自定义 providers |
--coverage.thresholds.functions <number> | 针对函数的覆盖度阈值设定，请访问 istanbuljs 了解更多信息。 此选项不适用于自定义 providers |
--coverage.thresholds.branches <number> | 针对 branches 的覆盖度阈值设定，请访问 istanbuljs 了解更多信息。 此选项不适用于自定义 providers |
--coverage.thresholds.statements <number> | 针对 statements 的覆盖度阈值设定，请访问 istanbuljs 了解更多信息。 此选项不适用于自定义 providers |
--coverage.ignoreClassMethods <name> | 覆盖时要忽略的类方法名称数组。更多信息请访问 istanbuljs 。该选项仅适用于 istanbul providers（默认值：[]）。 |
--coverage.processingConcurrency <number> | 处理覆盖率结果时使用的并发限制。 （默认最小值介于 20 和 CPU 数量之间） |
--coverage.customProviderModule <path> | 指定自定义覆盖范围提供程序模块的模块名称或路径。 请访问自定义 providers 覆盖范围 了解更多信息。 此选项仅适用于自定义 providers |
--coverage.watermarks.statements <watermarks> | High and low watermarks for statements in the format of <high>,<low> |
--coverage.watermarks.lines <watermarks> | High and low watermarks for lines in the format of <high>,<low> |
--coverage.watermarks.branches <watermarks> | High and low watermarks for branches in the format of <high>,<low> |
--coverage.watermarks.functions <watermarks> | High and low watermarks for functions in the format of <high>,<low> |
--mode <name> | 覆盖 Vite 模式 (默认值: test 或 benchmark) |
--workspace <path> | 工作区配置文件的路径 |
--isolate | 隔离运行每个测试文件。要禁用隔离, 使用 --no-isolate (默认值: true) |
--globals | 全局注入 |
--dom | 使用 happy-dom 模拟浏览器 API |
--browser.enabled | 在浏览器中运行测试。 相当于 --browser.enabled (默认值: false) |
--browser.name <name> | 在特定浏览器中运行所有测试。某些浏览器只适用于特定的 providers (比如 --browser.provider). 通过 browser.name 查看更多信息 |
--browser.headless | 在无头模式下运行浏览器（即不打开图形用户界面）。如果在 CI 中运行 Vitest，默认情况下将启用无头模式 (默认值: process.env.CI) |
--browser.api.port [port] | 指定服务器端口。注意，如果端口已被使用，Vite 会自动尝试下一个可用端口，因此这可能不是服务器最终监听的实际端口。如果为 true，将设置为 63315 |
--browser.api.host [host] | 指定服务器应该监听哪些 IP 地址。设为 0.0.0.0 或 true 则监听所有地址，包括局域网地址和公共地址 |
--browser.api.strictPort | 设置为 true 时，如果端口已被使用，则退出，而不是自动尝试下一个可用端口 |
--browser.provider <name> | 用于运行浏览器测试的 Provider。某些浏览器只适用于特定的提供 Provider，可以是"webdriverio", "playwright", "preview"，或自定义 provider. 通过 browser.provider 查看更多信息 (默认值: "preview") |
--browser.isolate | 隔离运行每个浏览器测试文件。要禁用隔离请使用 --browser.isolate=false (默认值: true) |
--browser.ui | 运行测试时显示 Vitest UI(默认值: !process.env.CI) |
--browser.fileParallelism | 浏览器测试文件是否应并行运行。使用 --browser.fileParallelism=false 可禁用 (默认值: true) |
--pool <pool> | 如果未在浏览器中运行，则指定 pool (默认值: threads) |
--poolOptions.threads.isolate | 在线程池中隔离测试 (默认值: true) |
--poolOptions.threads.singleThread | 在单线程内运行测试 (默认值: false) |
--poolOptions.threads.maxThreads <workers> | 运行测试的最大线程数或百分比 |
--poolOptions.threads.minThreads <workers> | 运行测试的最小线程数或百分比 |
--poolOptions.threads.useAtomics | 使用 Atomics 同步线程。这在某些情况下可以提高性能，但在较旧的 Node 版本中可能会导致 segfault。 (默认值: false) |
--poolOptions.vmThreads.isolate | 在线程池中隔离测试 (默认值: true) |
--poolOptions.vmThreads.singleThread | 在单线程内运行测试（默认值：false） |
--poolOptions.vmThreads.maxThreads <workers> | 运行测试的最大线程数或百分比 |
--poolOptions.vmThreads.minThreads <workers> | 运行测试的最小线程数或百分比 |
--poolOptions.vmThreads.useAtomics | 使用 Atomics 同步线程。这在某些情况下可以提高性能，但在较旧的 Node 版本中可能会导致 segfault。 (默认值: false) |
--poolOptions.vmThreads.memoryLimit <limit> | 虚拟机线程池的内存限制。如果发现内存泄漏，请尝试调整该值。 |
--poolOptions.forks.isolate | 在 forks pool 中隔离测试 (默认值: true) |
--poolOptions.forks.singleFork | 单个子进程内运行测试 (default: false) |
--poolOptions.forks.maxForks <workers> | 运行测试的最大进程数 |
--poolOptions.forks.minForks <workers> | 运行测试的最小进程数 |
--poolOptions.vmForks.isolate | 在 forks pool 中隔离测试 (default: true) |
--poolOptions.vmForks.singleFork | 在单个子进程内运行测试 (default: false) |
--poolOptions.vmForks.maxForks <workers> | 运行测试的最大进程数 |
--poolOptions.vmForks.minForks <workers> | 运行测试的最小进程数 |
--poolOptions.vmForks.memoryLimit <limit> | VM forks pool 的内存限制。如果你观察到内存泄漏问题，可以尝试调整这个值。 |
--fileParallelism | 是否所有测试文件都应并行运行. 使用 --no-file-parallelism 去禁用 (默认值: true) |
--maxWorkers <workers> | 同时并发执行测试任务的最大线程数或百分比 |
--minWorkers <workers> | 同时并发执行测试任务的最小线程数或百分比 |
--environment <name> | 如果不在浏览器中运行，则指定运行环境 (默认值: node) |
--passWithNoTests | 未发现测试时通过 |
--logHeapUsage | 在节点中运行时，显示每个测试的堆大小 |
--allowOnly | 允许执行那些被标记为"only"的测试用例或测试套件 (默认值: !process.env.CI) |
--dangerouslyIgnoreUnhandledErrors | 忽略任何未处理的错误 |
--shard <shards> | 测试套件分区的执行格式为 <index>/<count> |
--changed [since] | 运行受更改文件影响的测试 (默认值: false) |
--sequence.shuffle.files | 以随机顺序运行文件。如果启用此选项，长时间运行的测试将不会提前开始。 (默认值: false) |
--sequence.shuffle.tests | 以随机方式运行测试（默认值：false） |
--sequence.concurrent | 使测试并行运行（默认值：false） |
--sequence.seed <seed> | 设置随机化种子。如果 --sequence.shuffle（随机序列）是false，则此选项无效。 t 通过 "Random Seed" page 查看更多信息 |
--sequence.hooks <order> | 更改钩子的执行顺序。 可接受的值有: "stack", "list" and "parallel". 通过 sequence.hooks 查看更多信息 (默认值: "parallel") |
--sequence.setupFiles <order> | 更改设置文件的执行顺序。可接受的值有 "list" 和 "parallel"。如果设置为"list"，将按照定义的顺序运行设置文件。如果设置为 "parallel"，将并行运行设置文件（默认值："parallel"）。 |
--inspect [[host:]port] | 启用 Node.js 检查器（默认值：127.0.0.1:9229） |
--inspectBrk [[host:]port] | 启用 Node.js 检查器并在测试开始前中断 |
--testTimeout <timeout> | 测试的默认超时（毫秒）（默认值：5000）。 |
--hookTimeout <timeout> | 默认钩子超时（以毫秒为单位）（默认值：10000） |
--bail <number> | 当指定数量的测试失败时停止测试执行（默认值：0） |
--retry <times> | 如果测试失败，重试特定次数（默认值： 0）。 |
--diff <path> | 用于生成差异界面的差异配置的路径 |
--exclude <glob> | 测试中排除的其他文件路径匹配模式 |
--expandSnapshotDiff | 快照失败时显示完整差异 |
--disableConsoleIntercept | 禁用自动拦截控制台日志（默认值：false） |
--typecheck.enabled | 在测试的同时启用类型检查（默认值：false） |
--typecheck.only | 仅运行类型检查测试。这将自动启用类型检查（默认值：false） |
--typecheck.checker <name> | 指定要使用的类型检查器。可用值为 "tsc"和 "vue-tsc "以及一个可执行文件的路径（默认值：tsc） |
--typecheck.allowJs | 允许对 JavaScript 文件进行类型检查。默认值取自 tsconfig.json |
--typecheck.ignoreSourceErrors | 忽略源文件中的类型错误 |
--typecheck.tsconfig <path> | 自定义 tsconfig 文件的路径 |
--project <name> | 如果使用 Vitest 工作区功能，则为要运行的项目名称。多个项目可重复此操作： project=1--project=2。也可以使用通配符过滤项目，如 --project=packages* 。 |
--slowTestThreshold <threshold> | 测试速度慢的阈值（以毫秒为单位）（默认值：300） |
--teardownTimeout <timeout> | 拆卸函数的默认超时（以毫秒为单位）（默认值：10000） |
--maxConcurrency <number> | 套件中并发测试的最大次数（默认值：`5） |
--expect.requireAssertions | 要求所有测试至少有一个断言 |
--expect.poll.interval <interval> | 断言的轮询间隔 expect.poll() (默认值: 50) |
--expect.poll.timeout <timeout> | 断言的轮询超时（以毫秒为单位） expect.poll() (默认值: 1000) |
--printConsoleTrace | 始终打印控制台堆栈跟踪 |
--run | 禁用 watch 模式 |
--no-color | 删除控制台输出中的颜色 |
--clearScreen | 在 wathc 模式下重新运行测试时清除终端屏幕（默认值：true）。 |
--standalone | 启动 Vitest 而不运行测试。文件过滤器将被忽略，只有在发生变化时才会运行测试。(默认值:false) |
--mergeReports [path] | blob 报告目录的路径。如果使用此选项，Vitest 将不会运行任何测试，它将只报告以前记录的测试 |