Rust / 系统课时

读取命令行参数

读取命令行参数

本课演示如何读取 Rust 程序启动时收到的原始参数,并把字符串转换为整数和浮点数。完成后,你将得到一个可直接运行的命令行小程序,并能正确处理缺少参数和类型转换失败。

学习目标

  • 理解 std::env::args 返回的参数顺序
  • 将字符串参数转换为业务类型
  • 为参数缺失和格式错误提供清晰提示

参数从哪里来

Rust 标准库通过 std::env::args() 读取启动参数。迭代器中的第一个元素通常是程序路径,真正由用户输入的参数从第二个元素开始,因此常用 skip(1) 跳过程序自身。

所有参数最初都是 String。程序必须根据业务含义主动调用 parse::<T>(),才能得到 u32、f64 等具体类型。

完整示例

下面的程序接收“数量”和“单价”两个参数,计算总金额。它使用 Result 返回错误,避免直接 unwrap() 导致不友好的崩溃信息。

rust
use std::env;
use std::error::Error;

fn run() -> Result<(), Box<dyn Error>> {
    let mut args = env::args().skip(1);

    // 先检查参数是否存在,再执行类型转换。
    let quantity: u32 = args
        .next()
        .ok_or("缺少数量参数")?
        .parse()?;

    let unit_price: f64 = args
        .next()
        .ok_or("缺少单价参数")?
        .parse()?;

    if args.next().is_some() {
        return Err("参数过多:只需要数量和单价".into());
    }

    let total = quantity as f64 * unit_price;
    println!("数量: {quantity}");
    println!("单价: {unit_price:.2}");
    println!("总价: {total:.2}");
    Ok(())
}

fn main() {
    if let Err(error) = run() {
        eprintln!("参数错误: {error}");
        std::process::exit(2);
    }
}

预期结果:代码可通过编译;参数正确时输出计算结果,参数错误时输出原因并以状态码 2 结束。

在项目目录运行:

bash
cargo run -- 3 19.9

预期输出:

text
数量: 3
单价: 19.90
总价: 59.70

-- 用于分隔 Cargo 自身选项与目标程序参数。没有这个分隔符时,部分以短横线开头的内容可能被 Cargo 当成自己的选项。

处理常见边界

参数不足时,ok_or 会生成“缺少数量参数”或“缺少单价参数”。参数无法转换时,parse 会返回标准解析错误,例如把 abc 转为 u32 会失败。

当前示例还拒绝多余参数,适合参数数量固定的小工具。若程序需要可选参数、默认值、短选项或子命令,继续手写位置判断会迅速变复杂,应改用专门的命令行解析库。

还要注意:std::env::args() 要求参数是有效 UTF-8。需要处理任意操作系统字符串时,可改用 std::env::args_os(),再按平台需求转换。

本课总结

  • args() 返回的第一个元素通常是程序路径,业务参数应从后续元素读取
  • 命令行参数初始类型都是 String,需要显式转换为业务类型
  • 固定参数可用标准库完成,复杂选项应交给解析库

下一课预告

下一课将使用 clap 定义选项、默认值、子命令和自动帮助信息,让命令行接口从手工解析升级为类型安全的声明式配置。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读取命令行参数

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通