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 提供了基础数学工具
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 处理,将在后续课程深入。

  1. 给你之前的函数添加文档注释,用 cargo doc --open 查看效果。
  2. 用 println! 格式化打印圆周率到小数点后 4 位。
  3. 编写一个读取用户输入并回显的程序。
  • 普通注释:// 和 /* ... */
  • 文档注释:/// 和 //!,可用 cargo doc 生成。
  • println! 支持位置参数、命名参数和格式化控制。
  • 标准输入使用 std::io::stdin().read_line()。

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • rust/注释与基本输入输出.txt
  • 最后更改: 2026/08/12 23:30
  • 由 张叶安