7. 注释与基本输入输出
学习目标
- 掌握 Rust 注释的写法
- 理解
println!和格式化输出 - 初步了解标准输入读取
注释
单行注释
- snippet.rust
// 这是单行注释 let x = 5; // 注释也可以放在行尾
多行注释
- snippet.rust
/* * 这是多行注释 * 每行前面加 * 是风格,不是必须 */
文档注释
文档注释用 ///,支持 Markdown,可用 cargo doc 生成文档:
- snippet.rust
/// 计算两个数的和 /// /// # 示例 /// /// ``` /// let sum = add(1, 2); /// ``` fn add(a: i32, b: i32) -> i32 { a + b }
模块级文档用 //!:
- snippet.rust
//! 这个 crate 提供了基础数学工具
`println!` 格式化
基本用法
- snippet.rust
println!("Hello, world!"); println!("x = {}", x);
位置参数
- snippet.rust
println!("{0} + {1} = {2}", 1, 2, 3);
命名参数
- snippet.rust
println!("{subject} {verb} {object}", subject = "the quick brown fox", verb = "jumps over", object = "the lazy dog");
格式化控制
- snippet.rust
println!("Number: {:.2}", 3.14159); // 3.14 println!("{:08}", 7); // 00000007 println!("{:b}", 10); // 1010
标准输入
使用 std::io 读取输入:
- snippet.rust
use std::io; fn main() { println!("请输入一个数字:"); let mut input = String::new(); io::stdin() .read_line(&mut input) .expect("Failed to read line"); let input: i32 = input .trim() .parse() .expect("Please type a number!"); println!("你输入的是: {}", input); }
这段代码涉及借用和 Result 处理,将在后续课程深入。
小练习
- 给你之前的函数添加文档注释,用
cargo doc --open查看效果。 - 用
println!格式化打印圆周率到小数点后 4 位。 - 编写一个读取用户输入并回显的程序。
小结
- 普通注释:
//和/* ... */ - 文档注释:
///和//!,可用cargo doc生成。 println!支持位置参数、命名参数和格式化控制。- 标准输入使用
std::io::stdin().read_line()。