Debian上Rust的单元测试如何编写与执行

想在 Debian 上为 Rust 项目写单元测试？其实流程很直接，几步就能走通。下面按顺序拆开来说。

1. 安装 Rust

先确认系统里有没有 Rust 环境。如果没有，直接去官网（https://www.rust-lang.org/）按指引安装就行。最常用的方式是用下面这条命令搞定：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

跟着提示走，最后记得把 Rust 加到 PATH 环境变量里，这样后续操作才顺手。

2. 创建一个新的 Rust 项目

用 cargo 来新建项目，比如叫 my_project：

cargo new my_project

这条命令会在当前目录下生成一个 my_project 文件夹，里面已经包含了一个简单的 Rust 程序和一个 tests 目录，省得从头搭架子。

3. 编写单元测试

库项目的话，代码写在 src/lib.rs；可执行程序项目则写在 src/main.rs。测试代码通常和被测试的代码放在同一个文件里，用 #[test] 属性标记。举个例子，在 src/lib.rs 里写一个加法函数，再加一个测试：

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

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

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

这里的关键点：#[cfg(test)] 表示只有在运行测试时才会编译这个模块，不会影响正常产物。测试函数 test_add 用 assert_eq! 宏来验证结果是否符合预期。

4. 运行单元测试

在项目根目录下执行 cargo test，它会自动编译并运行所有测试：

cargo test

输出大致长这样：

running 1 test
test tests::test_add ... ok

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

看到 ok 就说明测试通过了。

5. 查看详细的测试输出（可选）

如果想看到更详细的日志，比如断言失败时的实际值和期望值，可以加上 --nocapture 参数：

cargo test -- --nocapture

这样每个测试的打印输出都会显示在终端里，调试时特别有用。

整体来看，Debian 上做 Rust 单元测试就是这么几步：装好环境，建个项目，写测试，跑起来。没有复杂配置，也没有额外依赖，上手非常顺滑。