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