《Rust编程入门》17.1 使用cargo bench进行性能测试

17.1 使用 cargo bench 进行性能测试

Rust 提供了一个强大的工具集来进行性能测试，cargo bench 是其中的一个工具，专门用于基准测试（benchmarking）。通过基准测试，我们可以测试代码的性能，并对比不同实现方案的执行速度，从而帮助我们识别和优化代码中的性能瓶颈。

1. 基准测试的概念

基准测试（Benchmarking）是衡量代码性能的过程，通常用于评估代码的执行时间、内存使用等关键指标。通过对比不同版本的实现，我们可以量化代码在不同条件下的表现。基准测试的核心目的是确保优化改进带来实际的性能提升，而不是空洞的理论预测。

在 Rust 中，基准测试可以通过 cargo bench 命令运行，帮助我们检测函数的执行时间，进而指导性能优化工作。

2. 如何启用基准测试

首先，Rust 官方自 2018 版起移除了 cargo bench 直接支持基准测试的功能。在当前版本中，基准测试通常需要依赖 criterion 或 test crate 来实现。以下是如何启用并使用这些工具进行性能基准测试的步骤。

2.1 添加依赖

为了使用基准测试，我们需要将 test 或 criterion crate 添加到 Cargo.toml 文件中：

1
2
3
4
5

[dependencies]
# Add regular dependencies here

[dev-dependencies]
criterion = "0.3"  # Criterion crate is one of the popular benchmarking libraries

criterion 提供了更加详细和精确的性能测试功能，是 Rust 社区常用的性能测试工具之一。

2.2 创建基准测试文件

基准测试代码通常放置在 benches 文件夹中。我们可以在项目根目录下创建 benches 文件夹并添加相应的测试文件。

1
2
3
4
5
6

my_project/
├── src/
│   └── lib.rs
├── benches/
│   └── benchmark.rs
├── Cargo.toml

在 benches/benchmark.rs 文件中，我们可以写出性能基准测试函数。例如：

1
2
3
4
5
6
7
8

use criterion::{black_box, Criterion};

fn bench_example(c: &mut Criterion) {
    c.bench_function("sum", |b| b.iter(|| (1..1000).sum::<i32>()));
}

criterion_group!(benches, bench_example);
criterion_main!(benches);

在这个示例中，我们创建了一个基准测试来测试数字从 1 到 1000 的求和操作。bench_function 通过 Criterion 的 iter 方法来运行测试，并测量该操作的执行时间。

• black_box：black_box 用于包裹代码，告诉编译器不要对其进行优化。它常用于性能测试中，确保代码不会被优化掉，从而影响性能测试的结果。

2.3 编写测试函数

在基准测试中，每个测试函数会被封装在 Criterion 提供的基准测试框架内。例如，我们可以编写多个函数来测试不同的代码路径：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

use criterion::{black_box, Criterion};

fn bench_sort(c: &mut Criterion) {
    let data = vec![5, 3, 8, 1, 2, 7];
    c.bench_function("sort", |b| b.iter(|| {
        let mut v = data.clone();
        v.sort();
        black_box(v);
    }));
}

criterion_group!(benches, bench_sort);
criterion_main!(benches);

在这个例子中，bench_sort 函数对一个小型的 Vec<i32> 进行排序，并用 black_box 包裹了结果，以避免编译器优化掉排序的结果。

2.4 运行基准测试

完成基准测试的编写后，可以使用 cargo bench 命令来运行它们。命令会编译并执行基准测试，输出性能数据。

1

cargo bench

运行后，cargo bench 会输出每个基准测试的执行时间，显示每次运行时所花费的平均时间、最大时间、最小时间等统计信息。

3. 解读基准测试结果

cargo bench 输出的结果会显示每个测试的性能数据，例如：

1

test bench_sort ... bench:   1,234 ns/iter (+/- 123)

这个结果表明 bench_sort 测试的平均执行时间为 1234 纳秒，标准偏差为 123 纳秒。基准测试通常会进行多次运行，并计算平均时间，从而减少偶然因素的影响。

4. 使用 Criterion 提供更多功能

虽然 cargo bench 可以运行基本的基准测试，但如果你需要更精确、更详细的性能分析，可以使用 criterion 提供的额外功能。criterion 提供了许多功能来帮助你分析性能数据，包括：

• 图形化结果：criterion 可以生成 HTML 格式的报告，展示每次基准测试的执行时间图表和性能趋势。
• 性能回归检测：criterion 会自动对比基准测试的历史结果，帮助你检测性能回归。
• 统计分析：criterion 提供了详细的统计分析数据，包括分位数（percentiles）、标准偏差等。

5. 性能测试中的注意事项

• 基准测试是相对的：性能测试应当根据相对比较进行，而不是绝对比较。由于硬件、操作系统等多种因素，执行时间可能会有所变化。基准测试结果通常应该关注于不同实现之间的差异。
• 避免早期优化：在性能测试时，过早的优化可能会适得其反，导致代码复杂性增加而带来不必要的性能开销。在做性能优化前，最好先进行基准测试，确保性能瓶颈明确。
• 测试环境的稳定性：执行基准测试时，确保测试环境尽可能稳定。其他程序的干扰、硬件负载、并行任务等因素都可能影响测试结果。

6. 总结

通过 cargo bench 和 criterion，Rust 提供了强大的性能测试工具，帮助开发者评估和优化代码的执行效率。通过精确的基准测试，我们可以识别代码中的性能瓶颈，进一步进行针对性的优化。在进行性能测试时，务必确保环境的稳定性，并根据实际情况做出合理的优化决策。

在下一节中，我们将深入探讨如何利用代码优化和剖析工具来进一步提高代码的执行效率。

• Rust
• Rust Tutors
• Rust编程入门