5.7 注释

为代码添加注释是编程的一个好习惯。Dart编程语言支持三种注释方式,分别为单行注释、多行注释和文档注释。

5.7.1 单行注释

单行注释以双斜杠(//)开始,以该行的末尾作为结束。如下:

img

在本书配套的示例代码中,大量使用了单行注释。

5.7.2 多行注释

多行注释以斜杠星号(/*)开始,以星号斜杠(*/)结束。如下:

img

5.7.3 文档注释

文档注释有两种写法:一种以三个斜杠(///)开始,以星号斜杠(*/)结束;另一种以斜杠两个星号(/**)开始,以星号斜杠(*/)作为结束。和单行/多行注释不同的是,文档注释还支持查找相关内容。如下:

img

中括号中的内容为查找关键字,它将搜索当前注释所在范围内和print有关的内容。