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 定义选项、默认值、子命令和自动帮助信息,让命令行接口从手工解析升级为类型安全的声明式配置。
按自己的节奏,确认真正理解。