跳到主要内容

其他 Rust 工具

除了 rustup、rustc 和 cargo 之外，Rust 生态系统还提供了许多有用的工具来提高开发效率和代码质量。

代码质量工具​

Rustfmt - 代码格式化​

Rustfmt 是 Rust 官方的代码格式化工具，确保代码风格的一致性。

# 安装 rustfmt
rustup component add rustfmt

# 格式化当前项目
cargo fmt

# 检查格式但不修改
cargo fmt -- --check

# 格式化单个文件
rustfmt src/main.rs

配置 rustfmt​

创建 rustfmt.toml 或 .rustfmt.toml 文件：

# rustfmt.toml
max_width = 100
hard_tabs = false
tab_spaces = 4
newline_style = "Unix"
use_small_heuristics = "Default"
reorder_imports = true
reorder_modules = true
remove_nested_parens = true
edition = "2021"

Clippy - 代码检查​

Clippy 是 Rust 的 lint 工具，提供代码改进建议。

# 安装 clippy
rustup component add clippy

# 运行 clippy
cargo clippy

# 将警告视为错误
cargo clippy -- -D warnings

# 修复可自动修复的问题
cargo clippy --fix

# 检查所有目标（包括测试、示例等）
cargo clippy --all-targets

Clippy 配置​

在 Cargo.toml 中配置：

[lints.clippy]
all = "warn"
pedantic = "warn"
nursery = "warn"
cargo = "warn"

# 禁用特定 lint
too_many_arguments = "allow"
module_name_repetitions = "allow"

测试和基准测试工具​

Criterion - 性能基准测试​

# 安装 criterion
cargo add --dev criterion

# 运行基准测试
cargo bench

示例基准测试：

// benches/my_benchmark.rs
use criterion::{black_box, criterion_group, criterion_main, Criterion};

fn fibonacci(n: u64) -> u64 {
    match n {
        0 => 1,
        1 => 1,
        n => fibonacci(n-1) + fibonacci(n-2),
    }
}

fn criterion_benchmark(c: &mut Criterion) {
    c.bench_function("fib 20", |b| b.iter(|| fibonacci(black_box(20))));
}

criterion_group!(benches, criterion_benchmark);
criterion_main!(benches);

Tarpaulin - 代码覆盖率​

# 安装 tarpaulin
cargo install cargo-tarpaulin

# 生成覆盖率报告
cargo tarpaulin --out Html

# 生成 XML 格式报告
cargo tarpaulin --out Xml

# 排除某些文件
cargo tarpaulin --ignore-tests --exclude-files "src/generated/*"

安全和审计工具​

Cargo Audit - 安全漏洞检查​

# 安装 cargo-audit
cargo install cargo-audit

# 检查已知安全漏洞
cargo audit

# 修复可修复的漏洞
cargo audit fix

# 生成报告
cargo audit --format json > audit-report.json

Cargo Deny - 依赖策略检查​

# 安装 cargo-deny
cargo install cargo-deny

# 初始化配置
cargo deny init

# 检查依赖
cargo deny check

# 检查许可证
cargo deny check licenses

# 检查安全漏洞
cargo deny check advisories

配置文件 deny.toml：

[licenses]
allow = ["MIT", "Apache-2.0", "BSD-3-Clause"]
deny = ["GPL-3.0"]

[bans]
multiple-versions = "warn"
wildcards = "allow"

[advisories]
vulnerability = "deny"
unmaintained = "warn"

文档工具​

mdBook - 文档生成​

# 安装 mdbook
cargo install mdbook

# 创建新书
mdbook init my-book

# 构建书籍
mdbook build

# 启动本地服务器
mdbook serve

# 测试代码示例
mdbook test

Cargo Doc - API 文档​

# 生成文档
cargo doc

# 生成并打开文档
cargo doc --open

# 包含私有项
cargo doc --document-private-items

# 生成依赖文档
cargo doc --no-deps

分析和调试工具​

Cargo Expand - 宏展开​

# 安装 cargo-expand
cargo install cargo-expand

# 展开宏
cargo expand

# 展开特定模块
cargo expand module_name

# 展开并保存到文件
cargo expand > expanded.rs

Cargo Asm - 查看汇编代码​

# 安装 cargo-asm
cargo install cargo-asm

# 查看函数的汇编代码
cargo asm crate::function_name

# 查看 LLVM IR
cargo llvm-ir crate::function_name

Valgrind 集成​

# 使用 valgrind 检查内存错误
cargo build
valgrind --tool=memcheck target/debug/my_program

# 使用 callgrind 进行性能分析
valgrind --tool=callgrind target/debug/my_program

跨平台和部署工具​

Cross - 交叉编译​

# 安装 cross
cargo install cross

# 为不同平台编译
cross build --target aarch64-unknown-linux-gnu
cross build --target x86_64-pc-windows-gnu

# 运行测试
cross test --target aarch64-unknown-linux-gnu

Cargo Lambda - AWS Lambda 部署​

# 安装 cargo-lambda
cargo install cargo-lambda

# 创建 Lambda 项目
cargo lambda new my-lambda

# 构建 Lambda 函数
cargo lambda build --release

# 部署到 AWS
cargo lambda deploy

项目管理工具​

Cargo Generate - 项目模板​

# 安装 cargo-generate
cargo install cargo-generate

# 从模板创建项目
cargo generate --git https://github.com/rust-cli/cli-template

# 使用本地模板
cargo generate --path ./my-template

Cargo Edit - 依赖管理​

# 安装 cargo-edit
cargo install cargo-edit

# 添加依赖
cargo add serde

# 添加开发依赖
cargo add --dev criterion

# 移除依赖
cargo rm old_dependency

# 升级依赖
cargo upgrade

性能分析工具​

Perf 集成​

# 编译带调试信息的发布版本
cargo build --release --profile release-with-debug

# 使用 perf 分析
perf record target/release/my_program
perf report

# 生成火焰图
perf record --call-graph dwarf target/release/my_program
perf script | stackcollapse-perf.pl | flamegraph.pl > flame.svg

Cargo Profiler​

# 安装 cargo-profiler
cargo install cargo-profiler

# 运行性能分析
cargo profiler callgrind --bin my_program

# 生成报告
cargo profiler cachegrind --bin my_program

开发环境工具​

Rust Analyzer - LSP 服务器​

# 安装 rust-analyzer
rustup component add rust-analyzer

# 手动安装最新版本
curl -L https://github.com/rust-analyzer/rust-analyzer/releases/latest/download/rust-analyzer-x86_64-unknown-linux-gnu.gz | gunzip -c - > ~/.local/bin/rust-analyzer
chmod +x ~/.local/bin/rust-analyzer

Bacon - 持续编译​

# 安装 bacon
cargo install bacon

# 启动持续编译
bacon

# 运行测试
bacon test

# 运行 clippy
bacon clippy

实用脚本和别名​

常用 Cargo 别名​

在 ~/.cargo/config.toml 中添加：

[alias]
b = "build"
c = "check"
t = "test"
r = "run"
rr = "run --release"
br = "build --release"
tr = "test --release"

开发脚本示例​

#!/bin/bash
# dev.sh - 开发环境检查脚本

echo "🔍 检查代码格式..."
cargo fmt -- --check

echo "📎 运行 Clippy..."
cargo clippy -- -D warnings

echo "🧪 运行测试..."
cargo test

echo "🔒 安全审计..."
cargo audit

echo "✅ 所有检查通过！"

这些工具组合使用可以大大提高 Rust 开发的效率和代码质量。建议根据项目需求选择合适的工具，并将它们集成到 CI/CD 流程中。