如何在Ubuntu上运行Rust测试

在 Ubuntu 上运行 Rust 测试

想在 Ubuntu 系统里顺畅地跑起 Rust 测试吗？这事儿其实不难，跟着下面这几个步骤走，从环境准备到问题排查，咱们一次搞定。

一 准备环境

工欲善其事，必先利其器。第一步，自然是把 Rust 的开发环境给搭起来。

• 安装 Rust 工具链（推荐方式）：最省心的办法就是通过 rustup 来安装。打开终端，执行下面这条命令，它会自动处理安装并更新你的 PATH 环境变量。
  • curl --proto ‘=https’ --tlsv1.3 https://sh.rustup.rs -sSf | sh
  • 安装完成后，别忘记运行 source “$HOME/.cargo/env” 来让配置立刻生效。
  • 怎么验证安装成功了呢？很简单，分别敲入 rustc --version 和 cargo --version，能看到版本号就对了。
• 安装构建依赖（链接器等）：为了后续编译顺利，一些系统级的构建工具必不可少。运行这条命令就能搞定。
  • sudo apt update && sudo apt install -y build-essential
• 可选 国内镜像加速（提升下载速度）：如果你身处国内，可能会觉得下载速度不尽如人意。这时候，配置一个国内镜像源能带来立竿见影的效果。
  • 可以在安装前设置环境变量：
    • export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
    • export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
  • 或者，更一劳永逸的办法是直接编辑 ~/.cargo/config.toml 文件来配置镜像源。

二 使用 Cargo 运行测试

环境就绪，接下来就是实战环节了。对于绝大多数 Rust 项目，Cargo 是管理依赖和运行测试的不二之选。

• 创建项目：让我们从一个新项目开始。执行 cargo new demo && cd demo，一个标准的 Rust 项目骨架就生成了。
• 编写测试：Rust 的测试通常写在源代码文件中。比如，在 src/lib.rs 里添加如下代码：
  • #[cfg(test)]
  • mod tests {
    • #[test]
    • fn it_works() {
      • assert_eq!(2 + 2, 4);
    • }
  • }
• 常用测试命令：Cargo 提供了丰富的测试命令来应对不同场景，掌握它们能让测试工作更加高效。
  • 运行全部测试：cargo test —— 这是最基础的命令。
  • 显示打印输出：cargo test -- --nocapture —— 当你想在测试运行时看到 println! 的输出时，这个参数就派上用场了。
  • 运行单个测试：cargo test it_works —— 只运行名为 “it_works” 的测试函数。
  • 按名称匹配运行：cargo test add —— 运行所有名称中包含 “add” 的测试。
  • 并行/单线程：cargo test -- --test-threads=1 —— 强制测试串行运行，对于某些有共享状态或资源竞争的测试很有用。
  • 只编译不运行：cargo test --no-run —— 检查测试代码能否编译通过，但不实际执行。
  • 显示测试覆盖的详细名称：cargo test -- --show-output —— 在测试通过时也显示其标准输出。
  • 运行特定模块：cargo test tests::it_works —— 运行指定模块内的测试。
• 集成测试：对于更复杂的测试，比如测试库的公开 API，就需要用到集成测试。在项目根目录下创建 tests/ 目录，然后新建一个如 integration_test.rs 的文件。在里面，你可以像外部用户一样，以 lib 或二进制 crate 的公开 API 为依赖来编写测试。运行方式很简单，cargo test 命令会自动发现并运行 tests/ 目录下的所有测试文件。

三 使用 rustc 的最小示例

当然，并非所有场景都需要 Cargo。对于极简的、无需依赖管理的单文件程序，直接用 rustc 编译器也是可行的。

• 适用于无需 Cargo 的极简场景
  • 假设我们有一个名为 test.rs 的文件，内容如下：
    • fn main() { println!(“Hello, world!”); }
    • #[cfg(test)]
    • mod tests {
      • #[test]
      • fn basic() { assert!(true); }
    • }
  • 编译与运行测试：只需两步。
    • rustc --test test.rs -o test （编译）
    • ./test （运行）
  • 不过话说回来，对于实际项目，使用 Cargo 来管理依赖和测试流程，无疑会更加方便和规范。

四 常见问题与排查

开发路上难免会遇到些小麻烦，这里整理了几个典型问题，帮你快速排雷。

• 报错 linker cc not found
  • 原因：系统里缺少必要的链接器或构建工具链。
  • 解决：执行 sudo apt install -y build-essential 安装即可。
• 命令未找到 cargo/rustc
  • 原因：系统的 PATH 环境变量没有包含 Rust 工具链的安装路径 $HOME/.cargo/bin。
  • 解决：可以临时执行 source “$HOME/.cargo/env”，或者为了永久生效，将这一行添加到你的 shell 配置文件（如 ~/.bashrc 或 ~/.profile）中。
• 测试输出看不到
  • 解决：默认情况下，Cargo 在测试通过时会捕获输出。想看到 println! 的内容？加上 -- --nocapture 参数：cargo test -- --nocapture。
• 想更快下载工具链或 crate
  • 解决：配置国内镜像源是提升下载速度的有效方法，具体配置步骤可以参考上文“准备环境”部分中的“国内镜像加速”。