在Ffltter中,//
用于创建单行注释,DART编译器会忽略该注释.
///
用于创建文档注释,该注释可用于使用dartdoc
工具为代码生成文档.DART编译器也会忽略此类注释,但它可用于为阅读代码的开发人员提供有关类、函数或变量的附加信息.
示例:
/// This is a documentation comment for a function
void myFunction() {
// this is a single-line comment
}
当你使用dartdoc
工具时,它会从代码中提取注释,并生成HTML格式的文档.
除此之外,请参阅有关dartdoc
guides-documenting-dart-libraries的官方文件.有关用法和示例,请参阅guides-dartdoc