flutter - 我应该使用//或///在 Dart 中进行评论吗?它会使应用程序变慢吗?

标签 flutter dart

当我检查包中的代码时,我发现它们同时使用 ///// 进行注释。

// 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/

相关文章:

php - 在flutter中获取JSON数据将返回NULL

authentication - 在 Flutter 中使用 Google Sign-In 获取用户的生日/性别

dart - Flutter - 如何清除焦点上的文本字段

firebase - Flutter firestore 快照始终为 null 或空列表

flutter - 如何将文本 Controller 的输入作为 double 输入? - flutter

firebase - 如何基于Flutter中FutureBuilder中另一个Firebase查询的值从Firebase查询获取数据?

dart - 列表属性继承

dart - 在 Flutter 中使用 Cloud Firestore 创建无限列表

dart - 以编程方式关注 InputField 并打开键盘

firebase - 使用 Firebase 存储时未定义类 StorageReference