实战项目

第34课:测试与CI

🎯 本课目标

掌握Rust测试体系:单元测试、集成测试、属性测试和CI/CD流水线。

1. 单元测试

pub fn add(a: i32, b: i32) -> i32 { a + b }

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_add() {
        assert_eq!(add(2, 3), 5);
        assert_eq!(add(-1, 1), 0);
    }

    #[test]
    fn test_add_overflow() {
        assert_eq!(add(i32::MAX, 1), i32::MIN);  // 溢出wrap
    }

    #[test]
    #[should_panic(expected = "除零")]
    fn test_divide_by_zero() {
        divide(1, 0);
    }

    #[test]
    fn test_option() -> Result<(), String> {
        let val: Option<i32> = Some(42);
        if let Some(v) = val {
            assert_eq!(v, 42);
            Ok(())
        } else {
            Err("应该是Some".into())
        }
    }
}

fn divide(a: i32, b: i32) -> i32 {
    if b == 0 { panic!("除零"); }
    a / b
}

✅ 编译验证通过

2. 集成测试

// tests/integration_test.rs
use myapp;

#[test]
fn test_full_workflow() {
    let result = myapp::process("input");
    assert!(result.is_ok());
}

3. 文档测试

/// 计算斐波那契数
///
/// # Examples
///
/// ```
/// use myapp::fib;
/// assert_eq!(fib(6), 8);
/// ```
pub fn fib(n: u32) -> u64 { /* ... */ }

4. CI/CD

// .github/workflows/ci.yml
name: CI
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
      - run: cargo test
      - run: cargo clippy -- -D warnings
      - run: cargo fmt --check
      - run: cargo build --release

5. 测试金字塔

╱╲ ╱ ╲ E2E测试(少量) ╱ ╲ — 慢、脆弱、贵 ╱──────╲ ╱ ╲ 集成测试(适量) ╱ ╲ — 中等速度 ╱────────────╲ ╱ ╲ 单元测试(大量) ╱________________╲ — 快、稳定、便宜 Rust内置支持所有层级: - #[test] 单元测试 - tests/ 集成测试 - doc tests 文档测试 - proptest 属性测试

📝 练习题

练习1:测试覆盖

用cargo-tarpaulin生成覆盖率报告。

练习2:属性测试

用proptest为排序算法写属性测试。

练习3:CI流水线

配置GitHub Actions完整CI。

🏆

成就解锁:质量守卫

掌握测试与CI——确保代码质量

🔬 深度理解:Rust工程实践

从学习到生产的桥梁——工程实践的关键要素:

1. 项目组织

Rust项目遵循workspace模式:核心逻辑在lib crate,二进制在bin crate,测试在独立目录。这确保了可测试性和可复用性。

2. 错误处理策略

库代码用Result传播错误,应用层用anyhow简化处理,CLI用自定义错误类型提供友好信息。

3. 配置管理

用serde解析配置文件,环境变量覆盖,合理默认值。十二因素应用方法论。

📊 Rust生产案例

公司/项目用途效果
Cloudflare边缘计算无GC停顿
Discord消息服务延迟降低40倍
Dropbox文件同步替代Go/Python
Linux内核驱动开发内存安全驱动
AmazonFirecracker VM125μs启动
MicrosoftWindows内核安全改进

🚀 进阶方向

完成本课程后,你可以选择以下进阶方向:

🧪 实战练习补充

以下练习帮助你将本课知识应用到实际场景:

练习A:代码审查

阅读以下代码片段,找出潜在问题并改进:

// 仔细阅读,思考有什么问题
fn process(data: Vec) -> Vec {
    let mut result = Vec::new();
    for i in 0..data.len() {
        result.push(data[i] * 2);
    }
    result
}

改进建议:使用迭代器、预分配容量、考虑溢出。

练习B:性能对比

用criterion基准测试对比以下实现的性能差异:

练习C:API设计

为以下场景设计Rust API:一个支持过期时间的缓存系统。考虑所有权、错误处理和泛型。

📌 本课要点总结

通过本课的学习,你应该掌握以下核心要点:

  1. 理解Rust核心概念背后的设计哲学
  2. 能够将所学知识应用到实际编码中
  3. 知道何时选择哪种工具和模式
  4. 具备阅读和审查Rust代码的能力
  5. 能够独立解决编译器报告的问题

如果某个要点还不够清晰,回顾本课的代码示例和内存图,动手编写代码验证你的理解。

🔗 相关资源

🎯 实战挑战

挑战自己:在不查看参考答案的情况下完成以下任务:

初级

用本课学到的知识,实现一个简单的功能模块。确保代码编译通过、有测试、有文档注释。

中级

将你的模块重构为更通用的版本,使用泛型和trait。添加错误处理。

高级

为你的模块实现并发安全版本,使用Arc+Mutex或channel。编写基准测试对比性能。


📚 扩展阅读

以下资源帮助你深入学习本课主题:

🔑 关键术语回顾

本课涉及的核心概念,确保你理解每一个:

术语说明
所有权Rust内存管理的核心机制,每个值有唯一所有者
借用通过引用访问数据,不获取所有权
生命周期引用有效的范围,编译期分析工具
traitRust的接口/抽象机制,类似其他语言的接口
泛型参数化类型,零成本抽象
模式匹配强大的数据解构和分支机制
零成本抽象高层抽象不引入运行时开销
fearless concurrency编译器保证线程安全

💬 学习建议

  1. 动手编码 — 每个代码示例都在本地运行一遍
  2. 修改实验 — 故意改错代码,看编译器报什么错
  3. 完成练习 — 每课的练习题是巩固知识的关键
  4. 阅读源码 — 看标准库和优秀开源项目的实现
  5. 写项目 — 真正掌握需要构建真实项目

🤔 常见问题

Q: Rust学习曲线真的很陡吗?

A: 前期确实需要适应所有权和借用检查器,但一旦理解了,这些概念会让你的代码更可靠。大多数人2-4周就能上手。

Q: Rust适合什么项目?

A: 系统编程、Web服务、CLI工具、嵌入式、WASM、网络服务、数据库等。基本上需要性能和安全的地方都适合。

Q: 遇到编译错误怎么办?

A: Rust编译器的错误信息非常友好!仔细阅读,通常会指出问题所在和修复建议。也可以用cargo clippy获取更多提示。