注释

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

  • 普通注释:编译器会忽略这些注释
    • // 行注释,从双斜杠开始到行尾。
    • /* 块注释,从开始符号到结束符号。 */
  • 文档注释:这些注释会被解析成 HTML 格式的库文档
    • /// 为接下来的项生成库文档。
    • //! 为当前项(如 crate、模块或函数)生成库文档。
fn main() {
    // 这是行注释的一个例子。
    // 在行首有两个斜杠。
    // 斜杠后面的内容编译器不会读取。

    // println!("Hello, world!");

    // 运行看看。明白了吗?现在试着删除这两个斜杠,再运行一次。

    /*
     * 这是另一种类型的注释,称为块注释。一般来说,推荐使用行注释。
     * 但是块注释在临时禁用大段代码时非常有用。
     * /* 块注释可以 /* 嵌套, */ */ 因此只需几次按键就能
     * 注释掉 main() 函数中的所有内容。
     * /*/*/* 你可以自己试试! */*/*/
     */

    /*
    注意:前面的 `*` 列纯粹是为了样式美观。实际上并不需要。
    */

    // 块注释比行注释更方便地操作表达式
    // 试试删除注释符号,看看结果会有什么变化:
    let x = 5 + /* 90 + */ 5;
    println!("`x` 是 10 还是 100?x = {}", x);
}

另请参阅:

库文档