注释

注释对任何程序都不可缺少，同样 Rust 支持几种不同的注释方式。

  • 普通注释，其注释内容将被编译器忽略掉：
    • // 单行注释，注释内容直到行尾。
    • /* 块注释， 注释内容一直到结束分隔符。 */
  • 文档注释，其注释内容将被解析成 HTML 帮助文档:
    • /// 对接下来的项生成帮助文档。
    • //! 对封闭项生成帮助文档。
  1. fn main() {
  2.     // 这是行注释的例子
  3.     // 注意这里有两个斜线在本行的开头
  4.     // 在这里面的所有内容编译器都不会读取
  6.     // println!("Hello, world!");
  8.     // 想要运行上述语句？现在请将上述语句的两条斜线删掉，并重新运行。
  10.     /*
  11.      * 这是另外一种格式的注释——块注释。一般而言，行注释是推荐的注释格式，
  12.      * 不过块注释在临时注释大块代码特别有用。/* 块注释可以 /* 嵌套, */ */
  13.      * 所以只需很少按键就可注释掉这些在 main() 函数中的行。/*/*/* 赶紧试试！*/*/*/
  14.      */
  16.      /*
  17.       注意，上面的例子中纵向都有 `*`，这完全是基于格式考虑，实际上这并不是
  18.       必须的。
  19.       */
  21.      // 观察块注释是如何对简单的表达式进行控制，而行注释不能这样操作。
  22.      // 删除注释分隔符将会改变结果。
  23.      let x = 5 + /* 90 + */ 5;
  24.      println!("Is `x` 10 or 100? x = {}", x);
  25. }

参见:

文档注释