dart 在另一个文件中显示来自另一个方法的文档

Question

是否可以在驻留在不同文件中的另一个函数的文档中显示一个函数的文档？宏只在它们自己的文件中有效。

在Flutter源码中，他们使用了类似这样的东西，但似乎没有任何效果：

/// {@macro flutter.widgets.editableText.keyboardType}

Answer 1

您最多可以 link 引用函数。

file_a.dart

/// Also see [functionB].
void functionA() {}

file_b.dart

/// Another function.
void functionB() {}

https://dart.dev/guides/language/language-tour#documentation-comments

Answer 2

宏文档 就是您要找的。它们已经 但总而言之，您可以完全按照自己的意愿行事：无需 re-write.

即可将文档从一个地方复制到其他地方