用 Rust 构建高性能 CLI 工具的 5 个实战技巧

命令行工具（CLI）是每个开发者的日常利器。相比 Python 或 Node.js，用 Rust 写 CLI 有天然优势：零成本抽象、无 GC 停顿、编译成单个二进制文件，分发极其方便。

本文分享 5 个在实际项目中总结的 Rust CLI 开发技巧。

1. 用 clap 做参数解析，derive 宏最省心

clap 是 Rust 生态中最流行的参数解析库。推荐用 derive 宏方式，代码简洁直观：

use clap::Parser;

#[derive(Parser)]
#[command(name = "mytool", about = "A fast file processor")]
struct Cli {
    /// Input file path
    #[arg(short, long)]
    input: String,

    /// Enable verbose output
    #[arg(short, long, default_value_t = false)]
    verbose: bool,

    /// Number of threads
    #[arg(short = j, long, default_value_t = 4)]
    threads: usize,
}

自动生成 --help、错误提示和 shell 补全，几行代码搞定。

2. 用 indicatif 给耗时操作加进度条

没人喜欢盯着一个没有反馈的终端等。indicatif 库可以轻松添加进度条：

use indicatif::{ProgressBar, ProgressStyle};

let pb = ProgressBar::new(total_files as u64);
pb.set_style(ProgressStyle::default_bar()
    .template("{spinner:.green} [{bar:40.cyan/blue}] {pos}/{len} ({eta})")
    .unwrap());

for file in files {
    process_file(&file)?;
    pb.inc(1);
}
pb.finish_with_message("Done!");

用户体验瞬间提升一个档次。

3. 用 rayon 实现零成本并行处理

处理大量文件或数据时，rayon 让并行化变得极其简单：

use rayon::prelude::*;

let results: Vec<_> = files
    .par_iter()
    .map(|f| process_file(f))
    .collect();

只需要把 .iter() 换成 .par_iter()，rayon 自动根据 CPU 核心数分配线程。实测处理 10 万个文件，比单线程快 6-8 倍。

4. 错误处理用 anyhow + thiserror 组合

• anyhow：适合应用层，快速传播错误
• thiserror：适合库层，定义明确的错误类型

// 应用层用 anyhow
use anyhow::{Context, Result};

fn read_config(path: &str) -> Result<Config> {
    let content = std::fs::read_to_string(path)
        .with_context(|| format!("Failed to read config: {}", path))?;
    let config: Config = toml::from_str(&content)
        .context("Invalid config format")?;
    Ok(config)
}

.context() 可以给错误加上有意义的上下文信息，调试时省大量时间。

5. 用 cross 做跨平台编译

发布 CLI 工具时，用户可能在 Linux、macOS、Windows 上使用。cross 工具基于 Docker，一行命令搞定交叉编译：

cargo install cross
cross build --release --target x86_64-unknown-linux-musl
cross build --release --target x86_64-apple-darwin
cross build --release --target x86_64-pc-windows-gnu

配合 GitHub Actions，可以在 CI 中自动构建多平台二进制，挂到 Release 页面。

总结

需求	推荐库
参数解析	clap
进度展示	indicatif
并行处理	rayon
错误处理	anyhow + thiserror
跨平台编译	cross

Rust 写 CLI 的开发体验已经非常成熟。编译后就是一个几 MB 的静态二进制，启动速度毫秒级，非常适合替代那些你用 Python 写的慢吞吞的脚本工具。

如果你还在犹豫要不要用 Rust 写 CLI，我的建议是：先从一个小工具开始，体验一下那种丝滑的速度感。