clap教程：第1章

最新推荐文章于 2025-12-07 17:05:22 发布

原创最新推荐文章于 2025-12-07 17:05:22 发布 · 516 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#开发语言

Rust 同时被 2 个专栏收录

7 篇文章

订阅专栏

编程开发

7 篇文章

订阅专栏

文章介绍了如何使用Rust的clap库通过derivemacro创建自定义命令行解析器，包括设置版本信息、帮助文本以及从Cargo.toml获取元数据。还展示了如何改变命令行为，如添加下一行帮助选项。

配置解析器

clap 可以使用 derive 宏 Parser 来开始构建解析器。

use clap::Parser;

#[derive(Parser)]
#[command(name = "MyApp")]
#[command(version = "1.0")]
#[command(about = "Does awesome things", long_about = None)]
struct Cli {
    #[arg(long)]
    two: String,
    #[arg(long)]
    one: String,
}

fn main() {
    let cli = Cli::parse();

    println!("two: {:?}", cli.two);
    println!("one: {:?}", cli.one);
}

$ 02_apps_derive --help
Does awesome things

Usage: 02_apps_derive[EXE] --two <TWO> --one <ONE>

Options:
      --two <TWO>  
      --one <ONE>  
  -h, --help       Print help
  -V, --version    Print version

$ 02_apps_derive --version
MyApp 1.0

还可以在结构体上使用 #[command(version, about)] 属性默认值来填充来自 Cargo.toml 文件的相关字段。

use clap::Parser;

#[derive(Parser)]
#[command(version, about, long_about = None)] // 从 `Cargo.toml` 读取
struct Cli {
    #[arg(long)]
    two: String,
    #[arg(long)]
    one: String,
}

fn main() {
    let cli = Cli::parse();

    println!("two: {:?}", cli.two);
    println!("one: {:?}", cli.one);
}

$ 02_crate_derive --help
A simple to use, efficient, and full-featured Command Line Argument Parser

Usage: 02_crate_derive[EXE] --two <TWO> --one <ONE>

Options:
      --two <TWO>  
      --one <ONE>  
  -h, --help       Print help
  -V, --version    Print version

$ 02_crate_derive --version
clap [..]

在结构体上使用 #[command] 属性可以更改 clap 的应用行为。任何 Command 构建器函数都可以用作属性，例如 Command::next_line_help。

use clap::Parser;

#[derive(Parser)]
#[command(version, about, long_about = None)]
#[command(next_line_help = true)]
struct Cli {
    #[arg(long)]
    two: String,
    #[arg(long)]
    one: String,
}

fn main() {
    let cli = Cli::parse();

    println!("two: {:?}", cli.two);
    println!("one: {:?}", cli.one);
}

$ 02_app_settings_derive --help
A simple to use, efficient, and full-featured Command Line Argument Parser

Usage: 02_app_settings_derive[EXE] --two <TWO> --one <ONE>

Options:
      --two <TWO>
          
      --one <ONE>
          
  -h, --help
          Print help
  -V, --version
          Print version