Flutter应用能否生成dartdoc？生成遇错误求解决方案

别担心，dartdoc完全支持Flutter应用，并不是只能用于包或插件！你的问题出在代码的类型声明和潜在的导入问题上，咱们一步步来解决：

1. 逐个修复编译错误 #

第一个错误：Invalid override. The type of 'AddLinkPage.createState' isn't a subtype of 'StatefulWidget.createState' #

虽然Dart允许子类方法返回父类返回类型的子类型，但dartdoc的静态分析对类型声明的要求更严格。你原来的写法在Flutter运行时没问题，但dartdoc没法正确识别隐式的类型关系。推荐改成标准的显式类型声明写法：

class AddLinkPage extends StatefulWidget {
  AddLinkPage({Key key}) : super(key: key);

  @override
  State<AddLinkPage> createState() => AddLinkPageState(); // 显式声明返回类型
}

class AddLinkPageState extends State<AddLinkPage> {
  // 你的状态逻辑代码
}

这样既符合Flutter最佳实践，也能让dartdoc正确识别方法返回类型，彻底解决第一个错误。

第二个错误：Classes can only extend other classes #

这个错误的核心原因几乎可以肯定是没正确导入Flutter的material库，导致State被当成了非类的标识符。请务必在文件最顶部添加：

import 'package:flutter/material.dart';

如果已经导入了，检查一下有没有拼写错误，或者是不是在代码某处自定义了State这个名字（比如变量、函数），不小心覆盖了Flutter自带的State类。

2. 正确生成dartdoc的步骤 #

等代码没有任何编译错误后，你就可以在项目根目录执行命令生成文档了：

• 用Dart命令：

dart doc

• 或者用Flutter命令（效果一致）：

flutter doc

生成的文档会存在项目根目录的doc/api文件夹里，打开里面的index.html就能查看完整的文档内容啦。

另外提个小技巧：如果你的应用里有以下划线_开头的私有成员，dartdoc默认不会生成它们的文档。如果需要包含这些内容，可以加上--include-undocumented参数：

dart doc --include-undocumented

内容的提问来源于stack exchange，提问作者Art