提示
如果你学过 C ,C++,java,C#.你可以跳过本节课,为什么,因为Rust的注释和这些语言几乎一样。
什么是注释?
写给人看的说明文字,编译器会忽略,不参与程序运行。
注释的作用有那些?
- 解释代码功能 :给人看,让代码更好理解
- 标注编写信息 :用来生成某些文档
- 临时屏蔽代码 :有些代码不删除,但也不想它执行,可以通过注释临时屏蔽
- 提升代码可读性
Rust的两/三种注释方式
- 行注释:从//开始并继续到行尾
- 块注释:可以注释一段代码,被封闭在内,可以跨越多行
/* ... */
注释,有点类似你读书的时候,在课本上面写的笔记,方便你理解课文。
我们先学习两种常见的注释,后面再学第三种。
fn main() {
// 单行注释以两个斜杠开头。直到这行的行尾
// 斜杠后的本行的所有内容都会被编译器忽略。
// 示例:这行代码不会执行
// println!("Hello, world!");
// 试着删除上面的斜杠,再次运行代码。
/*
* 块注释可用来临时禁用代码。例如看下面
* 它还支持嵌套:/* 像这样 */,能快速将大段代码注释掉。
*/
/*
* println!("Hello, world!");
* println!("Hello, world2!");
*/
/*
注意:左侧一列星号仅为排版样式,
并非语言语法要求。你可以不写它的。
*/
// 只需增删一个斜杠,就能利用块注释快速切换代码启用/禁用状态:
/* <- 在这里再加一个斜杠,即可解除下方整块注释(意思是 在/*前增加/ ---》//* 读者可以试试)
println!("现在");
println!("所有");
println!("代码都会执行!");
// 内部的单行注释不会受到影响
// */
// 块注释也可以写在表达式中间:
let x = 5 + /* 90 + */ 5;
println!("`x` 是 10 还是 100?x = {}", x);
}Code language: PHP (php)
以上这段代码,读者拷贝下来,自己试试,特别是/* <- 在这里再加一个斜杠,即可解除下方整块注释
(意思是 在/*前增加/ 变成//* 读者可以试试) 这样等于 这个块注释 少了一个/* 开始的部分,然后后面的// */ 又被// 注释了。
这样就等于临时删除了这个块注释。 中间的 println代码 就可以执行了

文档注释
文档注释,是可以通过工具,把注释的东西生成HTML格式的文档。方便程序员查阅。这个我们下节课,在独立一节课来学习。
Previous: rust的helloworld例子

