3.1-配置 cargo-criterion

Sat, 22 Aug 2026 20:00:00 +0800

译文 · 基于 Criterion.rs Documentation

配置 cargo-criterion

原文链接: https://bheisler.github.io/criterion.rs/book/cargo_criterion/configuring_cargo_criterion.html

cargo-criterion 可以通过在 crate 中（与 Cargo.toml 并列）放置 Criterion.toml 文件进行配置。

可用设置如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39


# 用于覆盖 cargo-criterion 保存数据和生成报告的目录。
criterion_home = "./target/criterion"

# 用于配置 cargo-criterion 命令行输出的格式。
# 可选值：
# criterion：打印测量值和吞吐量的置信区间，
# 并指示与上次运行相比是否检测到变化。默认值。
# quiet：与 criterion 类似，但不指示变化。适用于仅展示输出数字，
# 例如在库的 README 中。
# verbose：与 criterion 类似，但会打印额外统计信息。
# bencher：模拟 bencher crate 和仅 nightly 的 libtest 基准测试的输出格式。
output_format = "criterion"

# 用于配置 cargo-criterion 使用的绘图后端。
# 可选值为 "gnuplot" 和 "plotters"，或 "auto"（若 gnuplot 可用则使用 gnuplot，否则使用 plotters）。
plotting_backend = "auto"

# colors 表允许用户配置 cargo-criterion 生成的图表所使用的颜色。
[colors]
# 这些颜色在许多图表中用于将当前测量值与上一次测量值进行比较。
current_sample = {r = 31, g = 120, b = 180}
previous_sample = {r = 7, g = 26, b = 28}

# 这些颜色用于完整 PDF 图表，以突出显示哪些样本是异常值。
not_an_outlier = {r = 31, g = 120, b = 180}
mild_outlier = {r = 5, g = 127, b = 0}
severe_outlier = {r = 7, g = 26, b = 28}

# 这些颜色用于折线图，以比较多个不同的函数。
comparison_colors = [
 {r = 8, g = 34, b = 34},
 {r = 6, g = 139, b = 87},
 {r = 0, g = 139, b = 139},
 {r = 5, g = 215, b = 0},
 {r = 0, g = 0, b = 139},
 {r = 0, g = 20, b = 60},
 {r = 9, g = 0, b = 139},
 {r = 0, g = 255, b = 127},
]

3.2-外部工具

Sat, 22 Aug 2026 20:00:00 +0800

译文 · 基于 Criterion.rs Documentation

外部工具

原文链接: https://bheisler.github.io/criterion.rs/book/cargo_criterion/external_tools.html

cargo-criterion 提供机器可读的输出流，其他工具可以消费该流以收集有关 Criterion.rs 基准测试的信息。

要启用此输出流，请在运行 cargo-criterion 时传入 --message-format 参数。

JSON 消息

当传入 --message-format=json 时，cargo-criterion 将输出以下信息：

3-cargo-criterion on 编程那些事儿

3.1-配置 cargo-criterion

配置 cargo-criterion

3.2-外部工具

外部工具

JSON 消息