如何程序化检测Rust crate中未关联的单元测试文件？

DevOps 小满

2026-8-17

检测Rust项目中未关联的单元测试文件

问题背景

Rust官方测试文档指出，单元测试需放在带有#[cfg(test)]标记的模块中，且测试配置激活时才会运行。在大型项目里，常将单元测试拆分到独立文件，通过以下方式引入到主代码中：

#[cfg(test)]
#[path = "unit_tests/tests.rs"]
mod tests;

但这种模式下可能出现疏漏：有人删除了上述引用代码，却未删除对应的测试文件（比如src/unit_tests/tests.rs）。这要么是冗余文件未清理，要么是测试意外失效无法运行，因此需要在CI流程中自动检测这类未关联的测试文件。

注：集成测试放在crate的tests/目录会被自动编译，但单元测试不适用该规则。

解决方案

1. 使用`cargo unused-files`工具

这是一个专门检测项目中未被Cargo引用文件的社区工具，能直接识别未通过mod声明或#[path]关联的测试文件。

安装工具：
```
cargo install cargo-unused-files
```
在项目根目录运行检测：
```
cargo unused-files
```

在CI中加入这个命令即可，一旦检测到未使用的文件，工具会输出结果并返回非零退出码，触发CI告警。

2. 自定义脚本检测

如果需要更贴合项目的定制化逻辑，可以编写简单脚本实现检测：

示例Shell脚本

# 收集所有通过#[path]关联的测试文件路径
grep -r "#\[path = \"[^\"]*test.*\.rs\"" src/ | sed 's/.*path = "\(.*\)"/\1/' | sort > referenced_tests.txt

# 收集src目录下所有符合命名规则的测试文件
find src -name "*test*.rs" | sort > all_tests.txt

# 找出未被关联的测试文件
unused_tests=$(comm -23 all_tests.txt referenced_tests.txt)

if [ -n "$unused_tests" ]; then
  echo "发现未关联的测试文件："
  echo "$unused_tests"
  exit 1
fi

将这个脚本加入CI流程，若输出非空则终止CI，触发告警。