## Keyboard shortcuts

Press `←` or `→` to navigate between chapters

Press `S` or `/` to search in the book

Press `?` to show this help

Press `Esc` to hide this help

# 注释

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

- 普通注释：编译器会忽略这些注释
  - `// 行注释，从双斜杠开始到行尾。`
  - `/* 块注释，从开始符号到结束符号。 */`
- 文档注释：这些注释会被解析成 HTML 格式的库文档
  - `/// 为接下来的项生成库文档。`
  - `//! 为当前项（如 crate、模块或函数）生成库文档。`

    fn main() {
        // 这是行注释的一个例子。
        // 在行首有两个斜杠。
        // 斜杠后面的内容编译器不会读取。

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

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

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

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

        // 这里展示块注释的另一个强大用途：你可以通过添加或删除单个
        // '/' 字符来取消注释或注释整个代码块：

        /* <- 在第一个字符前再添加一个 '/' 来取消注释整个代码块

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

        // */

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

### 另请参阅：

库文档