手把手带你写 Rust 测试

Rust 自动化测试框架 Rust和Python测试框架对比摘要 Rust提供轻量级内置测试框架,通过#[test]属性和cargo test命令运行,支持单元测试、集成测试和文档测试。其测试编译为原生代码,执行速度快,线程隔离性好,但功能较为基础,复杂场景需依赖第三方库如proptest和mockall。 Python测试生态成熟,pytest为主流框架,支持fixtures、参数化测试等丰富功能,断言使用Python原生语法,调试方便。虽运行时性能不及Rust,但插件体系完善,适合快速迭代开发。 关键差异: 性能:Rust编译 阅读详情

手把手带你写 Rust 测试

Rust 从语言层面内置了一套开箱即用、零第三方依赖的测试框架,原生支持单元测试、集成测试、文档测试三大核心场景,实现了开发即测试、文档即测试的理念。

第一个单元测试用例

我们从最简单的单元测试场景入手,先写一个业务函数,再为它编写对应的测试用例。

打开 src/lib.rs,写入两个基础的业务函数:

/// 两个整数相加
pub fn add(a: i32, b: i32) -> i32 {
    a + b
}

/// 两个整数相除
pub fn divide(a: i32, b: i32) -> i32 {
    if b == 0 {
        panic!("Division by zero is not allowed");
    }
    a / b
}

在 src/lib.rs 文件末尾,添加 Rust 约定的单元测试模块:

// 测试函数通过 #[test] 属性标记,只有标记了该属性的函数才会被当作测试用例执行
#[cfg(test)]
mod tests {
    // 引入父模块的所有内容,可直接访问业务函数
    use super::*;

    // 标记该函数为测试用例
    #[test]
    fn add_should_return_correct_result() {
        // 执行业务逻辑
        let result = add(2, 2);
        // 断言:验证结果是否符合预期
        assert_eq!(result, 4);
    }
}

在项目根目录执行以下命令,运行所有测试:

cargo test

你会看到如下输出,代表测试执行成功:

running 1 test
test tests::add_should_return_correct_result ... ok

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s

Rust 内置了三个最常用的断言宏,如下所示:

宏作用示例
assert!验证布尔表达式为 trueassert!(add(2, 2) == 4);
assert_eq!验证两个值相等assert_eq!(add(2, 2), 4);
assert_ne!验证两个值不相等assert_ne!(add(2, 2), 5);

所有断言宏都支持自定义错误信息,方便调试定位问题:

#[test]
fn add_with_custom_error_msg() {
    let result = add(3, 5);
    assert_eq!(result, 8, "3 + 5 should be 8, but got {}", result);
}

错误处理场景

在实际开发中,除了正常逻辑,我们还需要测试不可恢复错误、Result 错误等边界场景,Rust 默认提供了相对应的方案。

测试 Panic 场景

当函数在特定场景下会触发 panic 时(比如上面的除零操作),我们可以通过 #[should_panic] 属性标记测试用例,验证 panic 是否会如期发生。

#[test]
// 标记该测试用例预期会触发 panic
#[should_panic]
fn divide_by_zero_should_panic() {
    divide(10, 0);
}

执行 cargo test,该测试会顺利通过。但这里有个问题:如果被测试的函数可能会触发多种 panic,我们如何去测试特定的 panic 呢?

为了精准匹配 panic 场景,我们可以添加 expected 参数,指定预期的 panic 信息:

#[test]
#[should_panic(expected = "Division by zero is not allowed")]
fn divide_by_zero_should_panic_with_exact_msg() {
    divide(10, 0);
}

只有当 panic 信息包含指定的字符串时,测试才会通过,避免误判。

测试 Result 场景

除了 panic,Rust 中更常用的错误处理方式是 Result<T, E> 类型。Rust 测试原生支持返回 Result 类型,无需 panic,还能使用 ? 运算符简化错误传播,代码更简洁优雅。

首先添加一个新函数 divide_safe,返回 Result 类型:

/// 安全的整数除法,返回 Result 类型
pub fn divide_safe(a: i32, b: i32) -> Result<i32, String> {
    if b == 0 {
        return Err("Division by zero is not allowed".to_string());
    }
    Ok(a / b)
}

然后编写对应的测试用例:

#[test]
fn divide_safe_should_return_correct_result() -> Result<(), String> {
    // 使用 ? 运算符,出错时直接返回 Err,终止测试
    assert_eq!(divide_safe(10, 2)?, 5);
    // 验证错误场景
    assert!(divide_safe(10, 0).is_err());
    // 测试通过,返回 Ok(())
    Ok(())
}

这种方式更符合 Rust 的错误处理哲学,也是官方推荐的错误场景测试方案。

第一个集成测试用例

集成测试用于验证库的对外公有 API 的行为是否符合预期,测试用例统一放在项目根目录的 tests 文件夹下,与 src 同级。

在项目根目录创建 tests 文件夹,再创建 tests/integration_test.rs,写入以下代码:

use test_example::*;

#[test]
fn test_add_public_api() {
    // 测试公有API的行为
    assert_eq!(add(10, 20), 30);
    assert_eq!(add(-5, 5), 0);
}

#[test]
fn test_divide_safe_public_api() {
    assert!(divide_safe(100, 10).is_ok());
    assert!(divide_safe(100, 0).is_err());
}

执行 cargo test,你会看到输出中新增了集成测试的执行结果,同时单元测试也会一起执行。如果只想执行指定的集成测试文件,可以使用以下命令:

# 仅执行 integration_test.rs 中的测试
cargo test --test integration_test

在实际开发中,多个集成测试文件经常需要复用一些通用逻辑(比如环境初始化、数据准备等),而且我们还不想把它们写到业务目录 src 中。

这时候,我们可以创建 tests/common/mod.rs,当然创建为 tests/common.rs 也可行,但不推荐,因为 Cargo 会将该文件视为测试 crate 并尝试运行其中的测试。

示例:创建 tests/common/mod.rs,写入通用逻辑:

pub fn setup_test_env() {
    println!("初始化测试环境:加载配置、连接数据库等");
    // 通用的测试初始化逻辑
}

在集成测试中引用通用模块:

// 引入通用模块
mod common;

#[test]
fn test_with_env_setup() {
    // 调用共享的初始化函数
    common::setup_test_env();
    assert_eq!(add(5, 5), 10);
}

第一个文档测试用例

Rust 最具特色的测试功能就是原生支持文档即测试,即文档注释中的代码块,会被 cargo test 自动识别为测试用例并执行,解决文档与代码不同步的痛点。

给 add 函数添加带测试的文档注释:

/// 两个整数相加
/// 
/// # Examples
/// 
/// ```
/// // 文档测试的代码块会被自动执行
/// use test_example::add;
/// 
/// assert_eq!(add(2, 3), 5);
/// assert_eq!(add(-1, 1), 0);
/// ```
pub fn add(a: i32, b: i32) -> i32 {
    a + b
}

执行 cargo test,你会看到输出中新增了 Doc-tests 部分,这说明文档测试已经被执行。

第三方库推荐

当内置的测试能力无法满足复杂场景时,可以使用社区成熟的第三方库扩展测试能力:

  • mockall,强大的 Mock 框架,模拟依赖接口,隔离测试环境
  • faker,假数据生成,支持多语言
  • criterion,Rust 生态系统中最流行的基准测试工具
  • cargo-fuzz,模糊测试工具,挖掘代码中的边界漏洞
  • cargo-nextest,新一代的 Rust 测试运行器,能够极大提升测试性能,可以完全替代 cargo test 命令。

总结

最后,好的测试不仅能保证代码的正确性,还能倒逼你写出更清晰、更易维护、耦合度更低的代码。希望本文能帮你快速掌握 Rust 测试的核心能力,写出更健壮的 Rust 项目。

Rust自动化测试的框架 摘要:本文介绍了使用Rust实现Web自动化测试的多种框架和方案。主要包括基于Selenium的thirtyfour框架、无浏览器模式的headless_chrome、移动端测试的Appium客户端,以及结合Django和Postman的测试方法。文章还涵盖了API测试、性能测试、多浏览器并行测试、视觉验证等场景,展示了Rust在自动化测试领域的多样化应用。关键实现包括测试框架集成、断言验证、异常处理、并发测试和报告生成等技术要点,为不同测试需求提供了完整的Rust解决方案。 阅读详情

相关推荐

【Rust测试】Rust代码测试方法详解与应用实战

测试是软件开发中不可或缺的重要环节,它能够确保代码质量、减少bug并提高软件的可靠性。 Rust语言从设计之初就内置了对测试的支持,提供了完善的测试框架和工具链。 本文将全面介绍Rust中的测试方法,从基础概念到高级技巧,并结合实际案例展示如何在Rust项目中实施有效的测试策略。

景天科技苑 4万+

Rust编写测试及控制执行

format!("Hello {}!(result.contains("孙飞"));使用cargo testfailures:thread 'tests::greeting_contains_name' panicked at 'assertion failed: result.contains(\"孙飞\")' , src/lib.rs:12:9failures:let target = "孙飞";assert!

m0_52796585的博客 1488

【Rust发邮件】Rust如何通过smtp协议发送邮件

在现代软件开发中,邮件发送功能是许多应用程序不可或缺的一部分。无论是用户注册验证、密码重置、通知提醒还是营销推广,邮件服务都扮演着重要角色。Rust作为一门系统级编程语言,以其安全性、并发性和高性能著称,同样可以用于实现邮件发送功能。 lettre 是 Rust 社区维护的一个成熟邮件发送库,支持多种 SMTP 模式、身份验证、HTML 邮件等。

景天科技苑 4万+

Rust单元测试实战

本文基于rust edition 2021 版本,介绍Rust Test用例编写及测试用例的运行。

bearboy80的专栏 743

MAX30102传感器实战:从寄存器配置到Arduino心率血氧监测

本文详细介绍了MAX30102传感器在Arduino平台上的实战应用,从寄存器配置到心率血氧监测的全过程。通过清晰的代码示例和实用技巧,帮助开发者快速实现脉搏血氧仪功能,包括I2C通信、FIFO数据处理及算法实现,适用于健康监测和可穿戴设备开发。

weixin_29182481的博客 511

手把手教你如何修改YOLO11的模型结构(以CBAM和可变性卷积为例)

YOLO11修改模型结构

2401_86807530的博客 1万+

完成第一次RUST单元测试

为了夯实基本知识和实际操作,当参与项目的成员多起来之后,就必然需要创建多人协作的项目。这样,代码健康性和安全性就非常重要。 本文利用RUST自身功能尝试进行单元测试验证,供广大程序员参考。

jackson_lingua的博客 329

Ubuntu开发环境配置——持续更新

本文简要介绍了Ubuntu下的开发环境配置流程和问题分析与解决,更多内容持续更新中。

m0_53365889的博客 2225

【Rust 基础篇】Rust 测试详解

本篇博客详细介绍了 Rust 中的测试,包括测试函数的编写、测试断言、测试组织以及测试覆盖率。通过充分利用 Rust 的测试框架和工具,我们可以编写高质量、可靠的 Rust 代码。希望本篇博客对你理解和应用 Rust 中的测试有所帮助。

繁依Fanyi的博客 2090

06 - 深度学习处理器原理

深度学习处理器的重要性在于它们可以加速深度学习任务的执行,从而推动了人工智能的发展。传统的通用处理器虽然可以执行深度学习任务,但它们不够高效,需要消耗大量的能量和时间。深度学习处理器通过硬件加速和特定设计来优化深度学习任务的执行,从而可以提高执行效率、降低能耗和加速训练和推断过程。 深度学习处理器的发展也推动了深度学习算法的创新,因为算法的发展需要硬件的支持和驱动。同时,深度学习处理器的出现也促进了更广泛的应用场景,包括自动驾驶、人脸识别、语音识别、图像识别等领域。因此,深度学习处理器的重要性不仅在于加速

m0_51339444的博客 755

14、PostgreSQL日志文件、系统统计与查询优化全解析

本文全面解析了PostgreSQL数据库中的系统统计、日志文件配置与查询优化技巧。详细介绍了如何利用pg_stat_statements模块进行性能监控,配置日志记录以发现潜在问题,并深入探讨了查询优化器的工作原理和优化策略。通过实际案例分析,展示了如何综合应用这些技术提升数据库性能。适合希望提升PostgreSQL性能与稳定性的数据库管理员和开发人员阅读。

efc123456的博客 94

Rust实战:单元测试与集成测试技巧解析

本文深入探讨了Rust语言的单元测试与集成测试,阐述了测试金字塔原则、TDD开发模式、持续集成等最佳实践。通过实战案例,介绍了如何编写单元测试、集成测试,以及如何使用模拟技术、测试覆盖率工具等提高代码质量。最后,强调了测试在软件开发过程中的重要性,以及在Rust社区中丰富的测试工具和资源。

silenceallat的博客 1696

linux v3h平台开发系列详解(GMSL摄像头篇):1.11 解串器MIPI 1.5G高速率特殊deskew配置

解串器max96712 deskew配置

xian18809311584的博客 1778

手把手带你写 Rust 文档

在 Rust 中,文档不是代码的“附属品”,而是程序开发的一部分。Rust 为文档提供了原生的工具链支持,达到文档即代码、文档即测试的效果,这也是为什么 Rust 生态的库普遍有极高的文档质量。这篇文章会手把手带你写 Rust 文档,从基础语法、高级技巧,到最佳实践,写出符合 Rust 社区规范、可维护、高可用性的技术文档。

github_28443763的博客 618

【ROS2】机械臂MoveIt2

navigation2 专注于移动机器人的导航与定位,处理大范围空间的底盘运动;MoveIt2 专注于机械臂的操作规划,处理多关节协同的末端执行器运动。在复合机器人(如,移动机械臂)navigation2 负责移动到目标区域,MoveIt2 负责机械臂抓取。官网:https://moveit.picknik.ai/main/index.html。

郭老二 603

一文搞定 ST22 短转储 MEMORY_NO_MORE_PAGING:看懂 SAP Paging 机制,参数 rdisp/PG_SHM 与 rdisp/PG_MAXFS 怎么设才稳

SAP系统MEMORY_NO_MORE_PAGING错误通常源于Paging资源耗尽而非物理内存不足。关键排查点包括:通过ST22确认错误类型,ST02监控Paging使用情况,检查工作进程trace中的"no more free blocks"提示。解决方案建议将rdisp/PG_SHM和rdisp/PG_MAXFS设为相同值(如250000块≈2GB),使Paging完全在内存中运行。同时需优化易耗Paging的代码逻辑,如避免滥用EXTRACT命令和超大内存对象传输。典型案例如月末

2007 年 ~ 2025 年,深耕 SAP 技术 18 年 336

Rust测试实战

最近在学习 Rust 的过程中,我开始关注测试。作为一个从后端转 Rust 的萌新,我认为了解 Rust 的测试是非常有必要的,它可以帮助我们确保代码的质量和可靠性。Rust 的测试系统非常强大,它提供了内置的测试框架,支持单元测试、集成测试和文档测试。今天,我就来分享一下 Rust 测试的相关知识和实战经验,希望能帮到和我一样的萌新们。测试是指验证代码是否符合预期行为的过程。Rust 的测试系统是其设计的重要组成部分,它提供了一种强大、灵活的测试方式。

no1coder的博客 4549

复分析 阿尔福斯(Ahlfors) 第三版答案 英文

答案分为十章,有部分习题没有答案,全英文复分析阿尔福斯(Ahlfors) 第三版答案

手把手教你写Rust单元测试,新手也能快速上手

掌握Rust单元测试编写技巧,解决初学者入门难题。通过实用示例讲解测试模块定义、断言使用与私有函数测试方法,适用于函数验证、逻辑校验等场景。代码清晰易懂,帮助快速构建可靠程序。Rust 单元测试 示例一应俱全,值得收藏。

DebugVibe的博客 721

计算机控制技术及应用

《计算机控制技术及应用》通过总结作者的科研成果和吸收国内外的先进理论、方法和技术,以计算机控制系统的网络化、开放化、智能化和集成化发展趋势为主线索,主要介绍计算机控制系统的基本概念和计算机控制系统的典型形式,计算机控制系统的数学描述与基本分析方法,以及数字PID控制器、最少拍控制系统、达林算法、状态变量设计法等设计方法及其各种改进算法。重点突出计算机控制系统输入输出通道接口的设计方法和典型控制系统的设计案例与实现方法等。

WINCC7.3破解文件

WINCC7.3硬件够破解文件,有需要的下载!WINCC7.3硬件够破解文件,有需要的下载!

Rust 测试代码应该放哪里?

Rust测试代码组织实践指南:单元测试通常写在实现文件内(使用#[cfg(test)]标记)或模块同级tests.rs中,可访问私有项;集成测试则放在项目根目录tests/中作为独立crate,仅能测试公开接口。小型模块推荐内联测试,大型项目应按模块层级拆分测试文件,保持测试与代码结构一致。关键原则是"小而精本地测,大而全拆模块,对外测放tests",既保证测试效率又便于维护扩展。

pumpkin84514的博客 1494

STM32F407中文手册

STM32f407中文手册 本参考手册面向应用开发人员,提供有关使用 STM32F405xx/07xx、STM32F415xx/17xx、 STM32F42xxx 和 STM32F43xxx 微控制器存储器与外设的完整信息。STM32F405xx/07xx、STM32F415xx/17xx、STM32F42xxx 和 STM32F43xxx 构成一个微 控制器系列,各产品具有不同的存储器大小、封装和外设。有关订购信息以及器件的机械与电气特性,请参见数据手册。有关 ARM Cortex™-M4F 内核的信息,请参见《Cortex™-M4F 技术参考手册》。

RUST:异步代码的测试与调试艺术

本文探讨了Rust异步代码的测试与调试艺术。首先分析了异步测试与同步测试的本质区别,指出异步测试面临时序性、状态管理和资源清理三大核心挑战。接着介绍了Tokio测试框架的基础用法,包括测试宏配置、异步函数测试和超时管理等实用技巧。最后展示了数据库集成测试的实践方法,强调测试后数据清理的重要性。文章通过丰富代码示例,为Rust开发者提供了异步测试的完整解决方案,帮助构建更可靠的异步应用系统。

编程世界如山海,探索不止。 2万+

2507rust,rust写驱动

2507rust,rust写驱动

个人进步之路 1248

rust的测试

一、测试 软件测试越来越受到所有开发人员的重视,当然,很多人也不重视。只是相对于以前来说。至少,现在技术型公司都安排了测试部门,以前可都是开发人员自己测试一下就OK了。Edsger W. Dijkstra 说“Program testing can be a very effective way to show the presence of bugs, but it is hopelessly inadequate for showing their absence.”可见软件测试多么重要又多么让人绝望。

fpcc的专栏 1569

Rust单元测试、集成测试

Rust 提供了单元测试和集成测试两种方式来帮助我们组织测试代码以解决代码正确性问题。单元测试的模块和待测试的代码在同一个文件中,且可以很方便地对私有函数进行测试集成测试文件放在项目根目录下的tests目录中,由于该目录下每个文件都是一个包,我们必须要引入待测试的代码到当前包的作用域中,才能进行测试,正因为此,集成测试只能对声明为pub的 API 进行测试下个章节,我们再来看看该如何使用对 Rust 项目进行持续集成。ripgrep。

m0_52796585的博客 2389

Rust 单元测试详细教程

Rust单元测试简明教程:测试代码通常放在#[cfg(test)]模块中,使用#[test]标记测试函数。核心断言宏包括assert!、assert_eq!和assert_ne!,可通过#[should_panic]测试预期panic。支持测试私有函数、条件编译和测试忽略功能。运行测试时可控制线程数、显示输出或执行特定测试。高级技巧包括使用mockall模拟对象、speculoos实现BDD风格测试,以及通过cargo tarpaulin检查测试覆盖率。典型示例展示了计数器结构体的基础测试方法,包含正常测试

本博客分享软硬件一体化开发实战。硬件涵盖 PCB 设计、STM32 等 MCU 底层开发;软件包含 C++、Rust,Qt/QML、PyQt、Slint、TouchGFX、LVGL 各类 GUI 框架。方便软硬件开发者查阅学习。欢迎关注! 1732

rules_rust测试框架深度解析:如何编写和运行rust_test与rust_test_suite

rules_rust是Bazel构建系统中用于Rust项目的强大规则集,提供了完善的测试框架支持。本文将详细介绍如何使用`rust_test`和`rust_test_suite`规则编写和运行Rust测试,帮助开发者构建可靠的测试流程。 ## 一、快速了解rust_test:单文件测试的终极方案 `rust_test`规则是rules_rust中最基础也最常用的测试规则,用于为单个Rust源文

gitblog_01066的博客 513

Rust基准测试 benchmark

几乎所有开发都知道,如果要测量程序的性能,就需要性能测试。性能测试包含了两种:压力测试和基准测试。前者是针对接口 API,模拟大量用户去访问接口然后生成接口级别的性能数据;而后者是针对代码,可以用来测试某一段代码的运行速度,例如一个排序算法。而本文将要介绍的就是基准测试benchmarkbenchmark事实上我们更推荐后者,原因在后文会详细介绍,下面先从官方提供的工具开始。

m0_52796585的博客 1253
上一篇: 手把手带你写 Rust 文档
下一篇: 为什么 Rust 等新兴编程语言集体放弃继承选择组合
Rust研习社
博客等级 码龄11年 52粉丝 84原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值