PAYATHON 2026

Flutter 应用显示默认计数器而非自定义 StatefulWidget(TodoApp)

数据小陈

结论

Flutter 不会自动找到 TodoApp 并把它显示出来。首屏显示什么,由 MaterialApp 的 home 决定。如果运行后看到的还是默认计数器,那说明当前实际运行的 MaterialApp.home 还指向 MyHomePage(或者同类的 counter 页面)。也可能是你改的 main.dart 没被当前运行配置用上,改动还没编译进应用。

常见原因

  1. main.dart 里还是 home: const MyHomePage(...),没换成 home: const TodoApp()。
  2. 项目里有多个 main.dart,IDE 运行配置用的入口不是 lib/main.dart。
  3. 只做了 hot reload。入口和 home 的改动要 hot restart 或重新 flutter run 才会生效。
  4. todo_app.dart 不在 lib/ 下、文件名大小写对不上,或者 import 'todo_app.dart'; 路径写错了。
  5. TodoApp 的类名、构造函数或 State<TodoApp> 写错,结果改到的是另一个文件。

修复步骤

先确认 lib/main.dart 里的 MaterialApp 只把首屏交给 TodoApp。可以先用下面这个最小结构排查:

import 'package:flutter/material.dart';
import 'todo_app.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
      ),
      home: const TodoApp(),
    );
  }
}

再确认 lib/todo_app.dart 里的 TodoApp 是公开类,createState 返回的类型也对:

class TodoApp extends StatefulWidget {
  const TodoApp({super.key});

  @override
  State<TodoApp> createState() => _TodoAppState();
}

接着把应用完全停掉,再重新运行。终端里依次执行 flutter clean、flutter pub get、flutter run;在 IDE 里至少用 hot restart。只按 hot reload 有时还会保留旧入口。

然后看 IDE 的 Run Configuration,确认 Dart entrypoint 是 lib/main.dart。项目里有多个 main.dart 时,尤其要确认当前运行的不是旧文件。

如果还是显示计数器,可以在 MyApp.build 里临时把 home 换成 const Text('TEST'),再重新运行一次。这样还是 counter,问题基本不在 TodoApp,而在运行入口或缓存;显示 TEST,就把 home: const TodoApp() 恢复回去,检查 todo_app.dart 的导入和类名。

注意事项

MyHomePage 这个类留着不影响首屏,只要 MaterialApp.home 不指向它就行。想少点误改,也可以把没用的 counter 页面删掉。TodoApp 里用了 TextEditingController,dispose 别丢。另外 todo_app.dart 必须真的放在 lib/ 下,导入路径和文件名大小写要一致,免得在 Windows 上能跑、换个平台就找不到文件。

备注:内容仅供参考。