注释

单行注释
多行注释
文档注释

Dart 支持单行注释、多行注释和文档注释。

单行注释以 // 开头。// 和行尾之间的所有内容都会被 Dart 编译器忽略。

dartvoid main() {
  // TODO: refactor into an AbstractLlamaGreetingFactory?
  print('Welcome to my Llama farm!');
}

多行注释以 /* 开头，以 */ 结尾。/* 和 */ 之间的所有内容都会被 Dart 编译器忽略（除非注释是文档注释；请参阅下一节）。多行注释可以嵌套。

dartvoid main() {
  /*
   * This is a lot of work. Consider raising chickens.

  Llama larry = Llama();
  larry.feed();
  larry.exercise();
  larry.clean();
   */
}

文档注释是多行或单行注释，以 /// 或 /** 开头。在连续行上使用 /// 与多行文档注释的效果相同。

在文档注释内部，分析器会忽略所有文本，除非文本包含在方括号中。使用方括号，您可以引用类、方法、字段、顶级变量、函数和参数。方括号中的名称在被文档化的程序元素的词法作用域中解析。

以下是文档注释的示例，其中引用了其他类和参数

dart/// A domesticated South American camelid (Lama glama).
///
/// Andean cultures have used llamas as meat and pack
/// animals since pre-Hispanic times.
///
/// Just like any other animal, llamas need to eat,
/// so don't forget to [feed] them some [Food].
class Llama {
  String? name;

  /// Feeds your llama [food].
  ///
  /// The typical llama eats one bale of hay per week.
  void feed(Food food) {
    // ...
  }

  /// Exercises your llama with an [activity] for
  /// [timeLimit] minutes.
  void exercise(Activity activity, int timeLimit) {
    // ...
  }
}

在该类的生成文档中，[feed] 变为指向 feed 方法文档的链接，而 [Food] 变为指向 Food 类文档的链接。

要解析 Dart 代码并生成 HTML 文档，您可以使用 Dart 的文档生成工具 dart doc。有关生成的文档示例，请参阅 Dart API 文档。有关如何构建注释的建议，请参阅Effective Dart: 文档。

除非另有说明，否则本网站上的文档反映的是 Dart 3.7.1 版本。页面上次更新于 2024-11-17。查看源代码或报告问题。