单元测试
test 属性
单元测试 是 CoddyKit 上的免费 Learn Rust Coding 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Learn Rust Coding 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Learn Rust Coding 课程共包含 4 节课。
在 Rust 中进行测试
Rust 内置测试功能，无需外部框架。测试是使用 #[test] 注解的普通函数，由 cargo test 运行。
您的第一个测试
测试函数不接受参数，并使用断言。如果它正常返回，则测试通过；如果发生恐慌，则测试失败。
fn add(a: i32, b: i32) -> i32 {
a + b
}
#[test]
fn it_adds() {
assert_eq!(add(2, 3), 5);
}
fn main() {
println!("{}", add(2, 3));
}断言宏
标准断言包括：
assert!(cond)— 条件为 false 时失败assert_eq!(a, b)— 两者不相等时失败assert_ne!(a, b)— 两者相等时失败
fn main() {
let x = 4;
assert!(x > 0);
assert_eq!(x, 4);
assert_ne!(x, 5);
println!("All assertions passed");
}tests 模块
按照惯例，单元测试放在使用 #[cfg(test)] 注解的模块中，因此它们仅在测试期间编译。
fn square(n: i32) -> i32 {
n * n
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn squares_correctly() {
assert_eq!(square(5), 25);
}
}
fn main() {
println!("{}", square(5));
}use super::*
由于测试模块是嵌套的，use super::* 会将父模块的项（即您要测试的函数）引入当前作用域。
运行测试
cargo test 会编译并运行每个测试。它会报告通过、失败或被忽略的测试数量。
cargo test测试恐慌
使用 #[should_panic] 断言某个函数在特定条件下会发生恐慌。
fn checked_div(a: i32, b: i32) -> i32 {
if b == 0 {
panic!("division by zero");
}
a / b
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
#[should_panic(expected = "division by zero")]
fn panics_on_zero() {
checked_div(10, 0);
}
}
fn main() {}返回 Result 的测试
测试可以返回 Result，从而可以使用 ? 运算符。返回 Err 会使测试失败。
fn parse(s: &str) -> Result<i32, std::num::ParseIntError> {
s.parse::<i32>()
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn parses_number() -> Result<(), std::num::ParseIntError> {
let n = parse("42")?;
assert_eq!(n, 42);
Ok(())
}
}
fn main() {}忽略测试
使用 #[ignore] 标记运行缓慢或依赖特定环境的测试。使用 cargo test -- --ignored 显式运行它们。
#[test]
#[ignore]
fn expensive_test() {
// long-running work
}
fn main() {}实用的测试标志
运行测试时的实用选项：
cargo test name— 运行名称匹配的测试cargo test -- --nocapture— 显示 println 输出cargo test -- --test-threads=1— 按串行方式运行
测试私有函数
由于测试模块嵌套在同一个文件中，因此它可以访问私有函数，而集成测试无法做到这一点。这是单元测试的一项重要优势。
fn internal(n: i32) -> i32 {
n + 1
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn tests_private() {
assert_eq!(internal(4), 5);
}
}
fn main() {
println!("{}", internal(4));
}快速检查
哪个属性可以将函数标记为应由 Cargo 运行的测试？
回顾
您学习了 Rust 内置的测试功能：
#[test]标记测试函数- 断言：
assert!、assert_eq!、assert_ne! - 测试位于带有
use super::*的#[cfg(test)]模块中 #[should_panic]和返回Result的测试可以处理错误cargo test运行所有内容
常见问题解答
「单元测试」课时是免费的吗？
是的 — 「单元测试」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Learn Rust Coding 课程的其余内容，请升级到 CoddyKit PRO。 Learn Rust Coding 课程共包含 4 节课。
「单元测试」这节课中我会学到什么？
test 属性 你通过在浏览器中直接运行的动手代码来练习 Learn Rust Coding，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Learn Rust Coding 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Learn Rust Coding 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「单元测试」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Learn Rust Coding 课中编写并运行代码吗？
能。每节 Learn Rust Coding 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。