1 使用 cargo-fuzz 进行模糊测试 on 编程那些事儿

1.1 安装

Sun, 23 Aug 2026 13:50:00 +0800

译文 · 基于 Rust Fuzz Book

安装

原文链接: https://rust-fuzz.github.io/book/cargo-fuzz/setup.html

环境要求

libFuzzer 需要 LLVM 消毒器支持；适用于 x86-64 Linux、x86-64 macOS、Apple Silicon（aarch64）macOS 以及 Windows（得益于 MSVC AddressSanitizer）。需要支持 C++11 的 C++ 编译器。Rust 提供多种编译器。本项目需要 nightly 编译器，因为它使用 -Z 编译器标志以启用地址消毒。若你通过 rustup 安装 Rust，可用以下命令检查默认编译器：

1.2 教程

Sun, 23 Aug 2026 13:50:00 +0800

译文 · 基于 Rust Fuzz Book

教程

原文链接: https://rust-fuzz.github.io/book/cargo-fuzz/tutorial.html

在本教程中，我们将对 URL 解析 crate rust-url 进行模糊测试。目标是找到模糊器生成的某种输入，在传给 Url::parse 时会导致 panic 或崩溃。

首先克隆 rust-url 仓库并进入该目录：

1.3 指南

Sun, 23 Aug 2026 13:50:00 +0800

译文 · 基于 Rust Fuzz Book

指南

原文链接: https://rust-fuzz.github.io/book/cargo-fuzz/guide.html

cargo-fuzz 所有可用命令：

1

cargo fuzz --help

运行某个目标：

1

cargo fuzz run <fuzz target name>

Cargo 特性

可使用命令行选项 --features、--no-default-features 和 --all-features 对启用不同 Cargo 特性配置的 crate 进行模糊测试。注意这些选项控制的是 fuzz_targets crate；你需要将它们转发到被模糊测试的 crate，例如在 fuzz_targets/Cargo.toml 中添加：

1.4 结构感知模糊测试

Sun, 23 Aug 2026 13:50:00 +0800

译文 · 基于 Rust Fuzz Book

结构感知模糊测试

原文链接: https://rust-fuzz.github.io/book/cargo-fuzz/structure-aware-fuzzing.html

并非每个被测系统都希望接受原始字节缓冲区作为输入；它可能希望得到某种结构化数据的良构实例。例如，模糊测试目标可能测试的系统及其期望的输入如下：

1.5 编写会访问数据的测试预言机

Sun, 23 Aug 2026 13:50:00 +0800

译文 · 基于 Rust Fuzz Book

编写会访问数据的测试预言机

原文链接: https://rust-fuzz.github.io/book/cargo-fuzz/oracles-accessing-data.html

Rust 要求引用必须指向有效值，如 Rust 参考手册所述：

引用或 Box<T> 必须对齐且非空，不能悬空，且必须指向有效值。

因此，高质量的 harness 应验证从目标库获得的每一个引用。

1.6 代码覆盖率

Sun, 23 Aug 2026 13:50:00 +0800

译文 · 基于 Rust Fuzz Book

代码覆盖率

原文链接: https://rust-fuzz.github.io/book/cargo-fuzz/coverage.html

可视化代码覆盖率有助于了解哪些代码路径正在被模糊测试覆盖，更重要的是——哪些还没有。为了帮助模糊器探索新代码路径，可以查看它未能到达的部分，然后添加新的种子输入到语料库，或调整模糊测试目标。本章介绍如何为模糊测试目标及其当前语料库生成覆盖率报告。

1.7 目标集合

Sun, 23 Aug 2026 13:50:00 +0800

译文 · 基于 Rust Fuzz Book

目标集合

原文链接: https://rust-fuzz.github.io/book/cargo-fuzz/targets.html

社区维护的、与 cargo-fuzz 兼容的模糊测试目标合集见此处。

1.9 在 CI 中模糊测试

Sun, 23 Aug 2026 13:50:00 +0800

译文 · 基于 Rust Fuzz Book

在 CI 中模糊测试

原文链接: https://rust-fuzz.github.io/book/cargo-fuzz/ci.html

在 CI 中短时间构建并运行模糊测试目标，作为冒烟测试会很有帮助。

若你使用的 CI 提供商未列于此，欢迎提交 PR 补充。

GitHub Workflows

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52


name: Smoke-Test Fuzz Targets

on:
 push:
 branches: [ "main" ]
 pull_request:
 branches: [ "main" ]

jobs:
 fuzz:
 runs-on: ubuntu-latest

 env:
 # 要安装和使用的 cargo-fuzz 版本。
 CARGO_FUZZ_VERSION: 0.12.0

 # 运行模糊测试目标的秒数。300 秒 = 5 分钟。
 FUZZ_TIME: 300

 strategy:
 matrix:
 include:
 # TODO: 在此列出你的模糊测试目标。
 - fuzz_target: my_first_fuzz_target
 - fuzz_target: my_second_fuzz_target
 # 等等...

 steps:
 - uses: actions/checkout@v4

 # 安装 nightly Rust 工具链。
 - run: rustup toolchain install nightly
 - run: rustup default nightly

 # 安装并缓存 cargo-fuzz。
 - uses: actions/cache@v4
 with:
 path: ${{ runner.tool_cache }}/cargo-fuzz
 key: cargo-fuzz-bin-${{ env.CARGO_FUZZ_VERSION }}
 - run: echo "${{ runner.tool_cache }}/cargo-fuzz/bin" >> $GITHUB_PATH
 - run: cargo install --root "${{ runner.tool_cache }}/cargo-fuzz" --version ${{ env.CARGO_FUZZ_VERSION }} cargo-fuzz --locked

 # 构建并运行模糊测试目标。
 - run: cargo fuzz build ${{ matrix.fuzz_target }}
 - run: cargo fuzz run ${{ matrix.fuzz_target }} -- -max_total_time=${{ env.FUZZ_TIME }}

 # 失败时上传模糊测试产物以便事后调试。
 - uses: actions/upload-artifact@v4
 if: failure()
 with:
 name: fuzzing-artifacts-${{ matrix.fuzz_target }}-${{ github.sha }}
 path: fuzz/artifacts