Rust:cargo bench命令运行基准测试

cargo bench 是 Rust 的包管理工具 Cargo 的一个子命令,用于执行 Rust 项目中的基准测试。基准测试是一种特殊类型的测试,旨在测量某段代码的性能,通常是通过计算特定任务执行所需的时间来实现。cargo bench 提供了一个简单的方式来运行这些性能测试,并收集性能数据。

启用基准测试

在 Rust 2018 版本及之后,基准测试默认在稳定版 Rust 中不可用,需要使用夜间版本的 Rust。你可以通过运行以下命令来安装夜间版本的 Rust:

bash 复制代码
rustup install nightly

然后,你可以通过在项目中运行基准测试时指定使用夜间版本:

bash 复制代码
cargo +nightly bench

编写基准测试

基准测试通常放在项目的 benches 目录下。如果这个目录不存在,你需要手动创建它。在 benches 目录中,每个测试文件都应该包含一个或多个基准测试函数。

这里是一个简单的基准测试例子,假设我们要测试一个函数 process_data 的性能:

rust 复制代码
#![feature(test)]

extern crate test;
use test::Bencher;

#[bench]
fn bench_process_data(b: &mut Bencher) {
    b.iter(|| {
        // 这里调用你想要测试性能的函数或代码块
        process_data();
    });
}

在这个例子中,#[bench] 属性用于标记一个基准测试函数。函数接收一个可变引用 &mut BencherBencher 类型提供了一个 iter 方法,接受一个闭包,闭包中是你想要测试性能的代码。iter 方法会多次执行这个闭包以获取平均性能数据。

运行基准测试

基准测试可以通过以下命令运行:

bash 复制代码
cargo +nightly bench

Cargo 会编译并运行项目中的所有基准测试,并输出每个测试的结果,包括执行时间等信息。

分析基准测试结果

基准测试的输出会告诉你每个测试运行了多少次,以及每次运行的平均时间。输出示例如下:

plaintext 复制代码
running 1 test
test bench_process_data ... bench:       1,234 ns/iter (+/- 123)

在这个示例中,bench_process_data 是测试函数的名字,1,234 ns/iter 表示每次迭代的平均纳秒数,(+/- 123) 是标准误差,表示结果的变异度。

下面是一个将 cargo bench 的选项整理成表格的示例,以方便查阅:

选项 参数 描述
--help 显示关于 cargo bench 命令的帮助信息。
--bench <NAME> 只运行指定名称的基准测试,其中 <NAME> 是基准测试的名称。
--no-run 编译但不执行任何基准测试,用于检查编译是否通过。
--package, -p <SPEC> 指定要测试的包,<SPEC> 是包的名称或路径。
--features <FEATURES> 启用指定的 Cargo 功能,<FEATURES> 是特性列表。
--all-features 启用包中定义的所有功能。
--no-default-features 不启用包的默认特性。
--target <TARGET> 指定一个目标平台,用于交叉编译。
--release 以优化模式编译基准测试。
--verbose, -v 显示执行命令的详细输出。
--color <WHEN> 控制输出中使用颜色的时机,<WHEN> 可以是 autoalwaysnever

from Pomelo_刘金,转载请注明原文链接。感谢!

相关推荐
Cyan_RA91 小时前
SpringMVC @RequestMapping的使用演示和细节 详解
java·开发语言·后端·spring·mvc·ssm·springmvc
ftpeak6 小时前
从零开始使用 axum-server 构建 HTTP/HTTPS 服务
网络·http·https·rust·web·web app
咸甜适中6 小时前
rust语言 (1.88) 学习笔记:客户端和服务器端同在一个项目中
笔记·学习·rust
用户214118326360210 小时前
Qwen3-Coder 实战!历史人物短视频一键生成,多分镜人物不崩,魔搭直接玩
后端
追逐时光者10 小时前
C#/.NET/.NET Core技术前沿周刊 | 第 54 期(2025年9.8-9.14)
后端·.net
追逐时光者10 小时前
C#/.NET/.NET Core编程技巧练习集,配套详细的文章教程讲解!
后端·.net
AD钙奶-lalala10 小时前
SpringBoot实现WebSocket服务端
spring boot·后端·websocket
moxiaoran575310 小时前
Flask学习笔记(一)
后端·python·flask
你的人类朋友11 小时前
🔒什么是HMAC
后端·安全·程序员
咸甜适中11 小时前
rust语言 (1.88) egui (0.32.2) 学习笔记(逐行注释)(二十八)使用图片控件显示图片
笔记·学习·rust·egui