使用clap库时App导入失败及Arg.with_name()方法报错问题

问题背景 #

我正在通过《Rust in Action》一书学习Rust，跟着书中示例编写一个类似grep的命令行工具，但程序无法正常运行，且在该书GitHub仓库中找不到对应示例。

环境信息 #

rustc --version
rustc 1.81.0 (eeb90cda1 2024-09-04)

项目配置（Cargo.toml） #

[package]
name = "grep-lite"
version = "0.1.0"
edition = "2021"

[dependencies]
clap = "4.5.17"
regex = "1"

原代码（src/main.rs） #

use regex::Regex;
use clap::{App,Arg};

fn main() {

    let args = App::new("grep-lite")
                  .version("0.1")
                  .about("searches for patterns")
                  .arg(Arg::with_name("pattern")
                          .help("The pattern to search for")
                          .takes_value(true)
                          .required(true)      
                  ).get_matches();

    let pattern = args.value_of("pattern").unwrap();              

    let re = Regex::new(pattern).unwrap();

    let quote = "Every face, every shop, bedroom window, public-house, and
  dark square is a picture feverishly turned--in search of what?
  It is the same with books. What do we seek through millions of pages?";
   
    for line in quote.lines() {
      let contains_substring = re.find(line); 
      match contains_substring {
            Some(_) => println!("{}", line),
            None => (),
      }
    }
  }

编译错误 #

cargo run
   Compiling grep-lite v0.1.0 (/Users/pnwlover/RustInAction/ch2/grep-lite)
error[E0432]: unresolved import `clap::App`
 --> src/main.rs:2:12
  |
2 | use clap::{App,Arg};
  |            ^^^ no `App` in the root

error[E0599]: no function or associated item named `with_name` found for struct `Arg` in the current scope
   --> src/main.rs:9:29
    |
9   |                   .arg(Arg::with_name("pattern")
    |                             ^^^^^^^^^ function or associated item not found in `Arg`
    |
note: if you're trying to build a new `Arg`, consider using `Arg::new` which returns `Arg`
   --> /Users/pnwlover/.cargo/registry/src/index.crates.io-6f17d22bba15001f/clap_builder-4.5.17/src/builder/arg.rs:114:5
    |
114 |     pub fn new(id: impl Into<Id>) -> Self {
    |     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Some errors have detailed explanations: E0432, E0599.
For more information about an error, try `rustc --explain E0432`.
error: could not compile `grep-lite` (bin "grep-lite") due to 2 previous errors

错误原因 #

问题很直接：你使用的是clap v4.x版本，但《Rust in Action》里的示例基于旧版clap（v2或v3）编写，两者API完全不兼容：

• 旧版的App结构体在v4里被替换成了Command
• 创建参数的Arg::with_name方法被废弃，改用Arg::new

修复后的代码 #

只需要修改clap相关的导入和初始化代码，其他逻辑完全不用动：

use regex::Regex;
// 替换为clap v4的正确导入
use clap::{Command, Arg};

fn main() {
    // 用Command替代原来的App
    let args = Command::new("grep-lite")
        .version("0.1")
        .about("searches for patterns")
        // 用Arg::new替代Arg::with_name
        .arg(Arg::new("pattern")
            .help("The pattern to search for")
            .takes_value(true)
            .required(true)
        )
        .get_matches();

    // 参数获取逻辑不变，也可以用更类型安全的get_one::<String>("pattern").unwrap()
    let pattern = args.value_of("pattern").unwrap();

    let re = Regex::new(pattern).unwrap();

    let quote = "Every face, every shop, bedroom window, public-house, and
  dark square is a picture feverishly turned--in search of what?
  It is the same with books. What do we seek through millions of pages?";
   
    for line in quote.lines() {
        let contains_substring = re.find(line); 
        match contains_substring {
            Some(_) => println!("{}", line),
            None => (),
        }
    }
}

验证修复 #

运行以下命令测试（把books换成你要搜索的关键词）：

cargo run -- "books"

会输出匹配的行：

It is the same with books. What do we seek through millions of pages?

内容的提问来源于stack exchange，提问作者PacificNW_Lover