package_api_docs

Provide doc comments for all public APIs.

此规则目前处于 deprecated 状态，自 Dart 2.0 版本起可用。

NOTE: This lint is deprecated because it is has not been fully functional since at least Dart 2.0. Remove all inclusions of this lint from your analysis options.

DO provide doc comments for all public APIs.

As described in the pub package layout doc, public APIs consist in everything in your package's lib folder, minus implementation files in lib/src, adding elements explicitly exported with an export directive.

For example, given lib/foo.dart:

export 'src/bar.dart' show Bar;
export 'src/baz.dart';

class Foo { }

class _Foo { }

its API includes:

• Foo (but not _Foo)
• Bar (exported) and
• all public elements in src/baz.dart

All public API members should be documented with /// doc-style comments.

BAD:

class Bar {
  void bar();
}

GOOD:

/// A Foo.
abstract class Foo {
  /// Start foo-ing.
  void start() => _start();

  _start();
}

Advice for writing good doc comments can be found in the Doc Writing Guidelines.

要启用 package_api_docs 规则，请在你的 analysis_options.yaml 文件中，在 linter > rules 下添加 package_api_docs ：

linter:
  rules:
    - package_api_docs

除非另有说明，否则本网站上的文档反映的是 Dart 3.6.0。页面最后更新于 2025-02-05。 查看源代码 或 报告问题.