注释

每个程序都需要注释，Rust 支持几种不同类型的注释：

普通注释

编译器会忽略这些注释：

• 行注释：以 // 开头，一直延续到行尾
• 块注释：使用 /* ... */ 包裹，可以跨越多行

文档注释（Doc Comments）会被解析成 HTML 格式的库文档：

• /// - 为紧随其后的项生成文档
• //! - 为其所在的项生成文档（通常用于文件或模块的顶部）

fn main() {
    // 行注释以两个斜杠开头。
    // 斜杠之后的所有内容都会被编译器忽略。

    // 示例：这一行不会执行
    // println!("Hello, world!");

    // 试着删除上面的斜杠，然后再次运行代码。

    /*
      块注释可用于临时禁用代码。
      它们也可以嵌套：/* 像这样 */ 这让快速
      注释掉大段代码变得很容易。
     */

    /*
     * 注意：左侧的星号列纯粹是为了样式美观，
     * 语言本身并不要求这么写。
     */

    // 块注释使得只需添加或删除一个斜杠
    // 就能轻松地开关代码：

    /* <- 在此处添加一个 '/' 即可取消注释下面整个代码块

    println!("Now");
    println!("everything");
    println!("executes!");
    // 内部的行注释不受影响

    // */

    // 块注释也可以在表达式内部使用：
    let x = 5 + /* 90 + */ 5;
    println!("`x` 是 10 还是 100？x = {}", x);
}

另请参阅：

库文档