2-用户指南 on 编程那些事儿

2.1-从 libtest 迁移

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

译文 · 基于 Criterion.rs Documentation

从 libtest 迁移

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/migrating_from_libtest.html

本页展示如何将 libtest 或 bencher 基准测试迁移为使用 Criterion.rs。

The Benchmark

以下面的基准测试为例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


#![feature(test)]
extern crate test;
use test::Bencher;
use test::black_box;

fn fibonacci(n: u64) -> u64 {
 match n {
 0 => 1,
 1 => 1,
 n => fibonacci(n-1) + fibonacci(n-2),
 }
}

#[bench]
fn bench_fib(b: &mut Bencher) {
 b.iter(|| fibonacci(black_box(20)));
}

The Migration

首先要更新 Cargo.toml，禁用 libtest 基准测试 harness：

2.2-命令行输出

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

译文 · 基于 Criterion.rs Documentation

命令行输出

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/command_line_output.html

本页输出由运行 cargo bench -- --verbose 产生。cargo bench 会省略部分信息。注意：若 cargo bench 因未知参数失败，请参阅 FAQ。

每个 Criterion.rs 基准测试会根据测量迭代计算统计量，并生成类似下面的报告：

2.3-命令行选项

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

译文 · 基于 Criterion.rs Documentation

命令行选项

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/command_line_options.html

注意：若 cargo bench 因未知参数失败，请参阅 FAQ。

Criterion.rs 基准测试接受多种自定义命令行参数。以下是最常用选项的列表。运行 cargo bench -- -h 可查看完整列表。

2.4-HTML 报告

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

译文 · 基于 Criterion.rs Documentation

HTML 报告

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/html_report.html

从 Criterion.rs 0.4.0 起，必须通过 html_reports feature 显式启用 HTML 报告：

1
2


[dev-dependencies]
criterion = { version = "0.5", features = ["html_reports"] }

Criterion.rs 可在 target/criterion/reports/index.html 生成展示基准测试结果的 HTML 报告。默认情况下，若可用则使用 gnuplot 生成图表，否则使用 plotters crate。以下示例由 gnuplot 后端生成，plotters 生成的图表类似。

2.5-图表

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

译文 · 基于 Criterion.rs Documentation

图表

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/plots_and_graphs.html

Criterion.rs 可生成多种有用的图表，便于更好理解基准测试行为。默认使用 gnuplot 生成，若不可用则回退到 plotters crate。以下示例由 gnuplot 后端生成，plotters 版本类似。

2.6-带输入的基准测试

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

译文 · 基于 Criterion.rs Documentation

带输入的基准测试

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/benchmarking_with_inputs.html

Criterion.rs 可使用一个或多个不同输入值运行基准测试，以研究性能如何随输入变化。

Benchmarking With One Input

若函数只有一个输入，可使用 Criterion 结构体上的简单接口运行该基准测试。

2.7-高级配置

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

译文 · 基于 Criterion.rs Documentation

高级配置

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/advanced_configuration.html

Criterion.rs 为更复杂的用例提供多种配置选项，本文档说明这些选项。

Configuring Sample Count & Other Statistical Settings

Criterion.rs 允许用户调整部分统计参数。最常见的方式是使用 BenchmarkGroup 结构——该结构的文档列出了可用设置。

2.8-比较函数

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

译文 · 基于 Criterion.rs Documentation

比较函数

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/comparing_functions.html

Criterion.rs 可以自动对函数的多种实现进行基准测试，并生成汇总图表以展示它们之间的性能差异。首先，让我们创建一个对比基准测试。我们还可以将其与对一系列输入进行基准测试结合起来。

2.9-CSV 输出

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

译文 · 基于 Criterion.rs Documentation

CSV 输出

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/csv_output.html

注意：CSV 输出正在逐步弃用。对于机器可读输出，建议使用 cargo-criterion 的 --message-format=json 选项——参见外部工具。CSV 输出将在 Criterion.rs 0.4.0 中成为可选功能。

Criterion.rs 将其测量结果保存在多个文件中，如下所示：

2.10-已知限制

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

译文 · 基于 Criterion.rs Documentation

已知限制

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/known_limitations.html

已知限制

目前，相对于标准基准测试 harness，Criterion.rs 的使用存在若干限制。

首先，Criterion.rs 必须使用 criterion_main 宏提供自己的 main 函数。这带来以下限制：

2.11-Bencher 兼容层

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

译文 · 基于 Criterion.rs Documentation

Bencher 兼容层

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/bencher_compatibility.html

Criterion.rs 提供了一个小型 crate，可作为 bencher 大多数常见用法的即插即用替代，便于现有 bencher 用户试用 Criterion.rs。本页展示如何使用该 crate 的示例。

2.12-计时循环

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

译文 · 基于 Criterion.rs Documentation

计时循环

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/timing_loops.html

Bencher 结构体提供多种函数，实现不同的计时循环以测量函数性能。本页说明这些计时循环的工作原理，以及在不同场景下应选用哪一种。

2.13-自定义测量

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

译文 · 基于 Criterion.rs Documentation

自定义测量

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/custom_measurements.html

默认情况下，Criterion.rs 测量基准测试的挂钟时间。然而，测量函数性能还有许多其他方式，例如硬件性能计数器或 POSIX 的 CPU 时间。自 0.3.0 版本起，Criterion.rs 支持接入替代计时测量。本页说明如何定义和使用这些自定义测量。

2.14-性能分析

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

译文 · 基于 Criterion.rs Documentation

性能分析

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/profiling.html

优化代码时，对其进行性能分析往往有助于理解其产生所测性能特征的原因。Criterion.rs 提供多项功能以协助对基准测试进行性能分析。

2.15-自定义测试框架

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

译文 · 基于 Criterion.rs Documentation

自定义测试框架

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/custom_test_framework.html

Rust 编译器的 nightly 版本支持自定义测试框架。Criterion.rs 提供了自定义测试框架的实验性实现，这意味着你可以使用 #[criterion] 属性标记基准测试，而无需使用常规的 criterion_group! / criterion_main! 宏。目前这需要一些不稳定特性，但未来某个时候 criterion_group! / criterion_main! 将被弃用，#[criterion] 将成为定义 Criterion.rs 基准测试的标准方式。若想提前试用此功能，请参阅下文文档。

2.16-基准测试异步函数

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

译文 · 基于 Criterion.rs Documentation

基准测试异步函数

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/benchmarking_async.html

异步函数基准测试

自 0.3.4 版本起，Criterion.rs 可选支持对异步函数进行基准测试。对异步函数的基准测试与常规函数相同，只是调用方必须提供 futures 执行器来运行基准测试。

2.17-快速模式

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

译文 · 基于 Criterion.rs Documentation

快速模式

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/quick_mode.html

快速模式

快速模式通过 --quick 标志启用，指示 criterion 在显著性水平低于某个值（默认 5%，参见 --significance-level 标志）后提前停止基准测试。

criterion 中的快速模式与 tasty-bench 的工作方式完全相同，后者有大量细节说明：https://github.com/Bodigrim/tasty-bench

2.18-WebAssembly/WASI

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

译文 · 基于 Criterion.rs Documentation

WebAssembly/WASI

原文链接: https://bheisler.github.io/criterion.rs/book/user_guide/wasi.html

Criterion 基准测试可以编译为 WebAssembly/WASI。这使你可以使用 wasmer 和 wasmtime 等运行时，以及 NodeJS 或 Web 浏览器（FireFox、Chrome、Safari）等 JavaScript 环境对代码进行性能测试。