为什么单击属性时未显示文档，但显示在窗口中

Question

截图：

您可以看到，当我按下 ctrl + j 快捷方式时，文档出现在窗口中，但是当我单击属性时，它确实将我带到了源代码，但没有文档。那么，那个窗口文档是从哪里来的呢？

Answer 1

您在按 Ctrl + J 时看到的那些行正在从预定义的文档块中获取描述。
@macro 用于插入该文档的和平。
请检查飞镖文档以更好地理解它https://github.com/dart-lang/dartdoc#macros。

所以文档模板位于<your flutter_dir>/packages/flutter/lib/src/widgets/editable_text.dart 内 如：

/// {@template flutter.widgets.editableText.autocorrect}
/// Whether to enable autocorrection.
///
/// Defaults to true. Cannot be null.
/// {@endtemplate}
final bool autocorrect;