flutter - 我应该使用//还是///在Dart中发表评论？它会使应用变慢吗？

Question

当我检查软件包中的代码时，我看到它们同时使用 // 和 /// 进行注释。

// is a normal comment.

/// is a highlighted comment.

似乎使用///更好，那么为什么要同时使用它们呢？在Dart中使用注释时，是否会使应用变慢？

Answer 1

不要使用/// doc注释来记录成员和类型。

使用文档注释而不是常规注释使dartdoc能够找到它并为其生成文档。

例:

    /// The number of characters in this chunk when unsplit.
int get length => ...

请参阅官方指南 here。

由于历史原因，dartdoc支持两种文档注释语法: ///(“C#样式”)和 /** ... */(“JavaDoc样式”)。我们更喜欢 ///，因为它更紧凑。 /** and */将两条无内容的行添加到多行doc注释中。在某些情况下，例如文档注释包含使用*标记列表项的项目符号列表时， ///语法也更易于阅读。

如果您偶然发现仍然使用JavaDoc样式的代码，请考虑对其进行清理。

在Dart中使用评论时，是否会使应用变慢？

否，dart编译器会将其从发行版本中删除。