当我检查包中的代码时,我发现它们同时使用 // 和 /// 进行注释。
// is a normal comment.
/// is a highlighted comment.
看起来使用///更好,那么为什么他们同时使用它们呢?在 Dart 中使用注释时,它是否会使应用程序变慢?
最佳答案
请使用///文档注释来记录成员和类型。
使用文档注释而不是常规注释可以启用 dartdoc找到它并为其生成文档。
示例:
/// The number of characters in this chunk when unsplit.
int get length => ...
查看官方指南here .
由于历史原因,dartdoc 支持两种文档注释语法:///
(“C# 风格”)和 /** ... */
(“JavaDoc风格”)。我们更喜欢 ///
因为它更紧凑。 /** 和 */
将两行无内容行添加到多行文档注释中。在某些情况下,///
语法也更易于阅读,例如当文档注释包含使用 * 标记列表项的项目符号列表时。
如果您偶然发现仍然使用 JavaDoc 样式的代码,请考虑清理它。
在 Dart 中使用注释时会导致应用变慢吗?
不,dart 编译器会将它们从发布版本中删除。
关于flutter - 我应该使用//或///在 Dart 中进行评论吗?它会使应用程序变慢吗?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/60824301/