跳到正文
CH 06异步与事件Flutter8 分钟阅读

Flutter 交互与状态:StatefulWidget、setState、生命周期

第 6 章 · Flutter 交互与状态:StatefulWidget、setState、生命周期

本章示例examples/ch06-state在线阅读源码下载 zip

run

$cd examples/ch06-state && flutter run -d macos(Linux/Windows 同理)

已验证

  • flutter analyze 0 告警、flutter test 10 个用例全绿、flutter build macos --debug 真实构建并启动成功
  • 完整工程已打包:打包下载
本章目录 · 15 节

6.1 本章目标

  • 搞清 StatefulWidget 与 State 的分工:Widget 不可变,State 跨 build 存活;
  • 会用 setState,并知道"同一帧多次 setState 只重建一次";
  • 背下生命周期顺序:createState → initState → didChangeDependencies → build → didUpdateWidget → dispose;
  • 把 ch05 的 Future/Stream 塞进 initState/dispose,并避开 Flutter 三大经典运行时错误:
    1. setState() called after dispose()
    2. 忘记 cancel 订阅 / dispose controller
    3. 在 build 里发起副作用(请求、改状态)
  • 会写 widget 测试覆盖"交互 → 状态变化 → UI 更新"这条链路。

6.2 StatefulWidget 与 State:谁存状态

dartlib/src/state_demo_page.dart源文件
// examples/ch06-state/lib/src/state_demo_page.dart
class CounterCard extends StatefulWidget {
  const CounterCard({super.key, this.step = 1});
  final int step;                       // 父级传入的配置,不可变
  @override
  State<CounterCard> createState() => _CounterCardState();
}

class _CounterCardState extends State<CounterCard> {
  int _count = 0;                       // 状态:跨 build 存活

  void bump(int delta) => setState(() => _count += delta * widget.step);
  ...
}

三件事必须分清:

东西 可变? 生命周期 放什么
Widget 不可变 每次 build 都可能换新实例 配置、回调、子 Widget
State 可变 与 Element 同寿命(页面在,它就在) 可变字段、controller、订阅
BuildContext — 随 Element 向上查找祖先

State 里用 widget.x 访问当前的 Widget 配置。父级重建、传了新参数时,Widget 是新的,但 State 是同一个——所以 _count 不会丢。

createState 只在第一次挂载时调用。这就是为什么"切换父级参数不会重置计数器"(示例里的第二个用例专门断言了这点)。

6.3 setState:告诉框架"这个子树需要重建"

dart
void bump(int delta) => setState(() => _count += delta * widget.step);

规则:

  1. setState 里只做同步的状态修改,不要 await;
  2. 改完状态后框架会把该 State 标脏,在下一帧重建这个 State 的 build 子树;
  3. 同一帧内多次 setState 只重建一次(框架合批),实测:
text
count = 0 → 点 +1 → count = 1,build 次数 = 2
同一帧内 +1 再 -1 → count 恒为 1,build 次数只涨 1(不是 2)

这解释了为什么"按钮连点 10 次"不会重建 10 次——但注意:每次点击仍然会改状态,只是渲染合并了。

项 C/Go GUI Flutter
更新 UI 直接调 API 改控件属性(SetWindowText) 改状态 + setState,让框架重新 build
谁负责重绘 你 框架(diff + 局部重建)
状态放哪 全局变量/结构体成员 State 字段(局部)或 Riverpod(全局,ch11)
刷新粒度 手工控制 自动:只重建标脏的子树

setState 的三个禁用场景

场景 后果 正确做法
build 里调用 死循环 / 断言失败 副作用放到 initState 或事件回调
dispose 之后调用 setState() called after dispose() await 之后先判 if (!mounted) return;
构造函数里调用 setState() called in constructor 直接给字段赋初值

6.4 生命周期:一张图背完

text
createState()
  └─ initState()                 ← 只调用一次;初始化 controller / 发起首次请求 / 订阅
       └─ didChangeDependencies()← initState 之后;依赖的 InheritedWidget 变化时再次触发
            └─ build()           ← 每次需要重绘都会调用,可能非常频繁
                 ├─ didUpdateWidget(oldWidget)  ← 父级传了新配置(State 复用)
                 └─ deactivate() → dispose()    ← 移出树;这里释放一切资源

示例里的 LifecycleProbe 把每个回调记进列表,测试断言了真实顺序:

dart
await tester.pumpWidget(host(LifecycleProbe(log: log)));
expect(log, ['probe:initState', 'probe:didChangeDependencies', 'probe:build']);

log.clear();
await tester.pumpWidget(host(LifecycleProbe(log: log, label: 'renamed')));
// 同一 State 被复用:没有 initState,只有 didUpdateWidget + build
expect(log, contains('renamed:didUpdateWidget(probe→renamed)'));
expect(log, isNot(contains('renamed:initState')));

await tester.pumpWidget(host(const Text('gone')));
expect(log, ['renamed:dispose']);

陷阱:didUpdateWidget 里读 widget.label 已经是新值,旧值在 oldWidget 里。示例第一版断言写成 probe:didUpdateWidget(...),因为日志用的是 widget.label 而失败——记录日志时到底该用哪个,取决于你想看"现在的身份"还是"变化"。

didChangeDependencies 什么时候再触发

它会在 initState 之后调用一次,之后只要 State 依赖的 InheritedWidget(Theme、MediaQuery、Localizations、自定义 Provider)变化就再次触发。典型用途:主题/语言切换后重算某些值。

不要在这里发请求——它可能被调用多次。发请求放 initState。

6.5 三种真实状态来源

本章示例把状态按来源分成四张卡片,正好覆盖实际项目里的全部情况。

① 纯内存状态(CounterCard)

最简单:字段 + setState。适合"只影响本页面"的 UI 状态(展开/收起、当前 tab、输入草稿)。

② 用户输入(TodoCard)

TextEditingController 是有生命周期的资源(它连着原生输入法、选区、监听器):

dart
final TextEditingController _controller = TextEditingController();

@override
void dispose() {
  _controller.dispose();   // 忘了这一行 = 泄漏
  super.dispose();
}
项 C Flutter
输入框内容 你自己维护 char buf[N] + 同步回调 controller.text(框架维护)
资源释放 free / close(fd) controller.dispose()
泄漏后果 内存/句柄泄漏 内存泄漏 + 调试断言(A TextEditingController was used after being disposed)

一个反直觉点:TextField 的值不在 State 的字段里,而在 controller 里。想在"文本框变化时做点什么",用 onChanged 或监听 controller,而不是 setState 包起来。

③ 异步结果(AsyncCard)

dart
@override
void initState() {
  super.initState();
  unawaited(_load());            // initState 不能 async,只能"发射后不管"
}

Future<void> _load() async {
  setState(() { _loading = true; _error = null; });
  try {
    final String value = await Future<String>.delayed(widget.delay, () => '服务器返回: 42');
    if (!mounted) return;        // ★ await 之后必须检查
    setState(() { _data = value; _loading = false; });
  } catch (e) {
    if (!mounted) return;
    setState(() { _error = e; _loading = false; });
  }
}

mounted 是 State 上的 getter:Element 还挂在树上就是 true。任何 await 之后碰 setState/context 之前,都要先判 mounted。

测试里专门构造了"页面在 Future 完成前被销毁"的场景:

dart
await tester.pumpWidget(host(const AsyncCard()));
await tester.pumpWidget(host(const Text('已卸载')));   // 提前卸载
await tester.pump(const Duration(milliseconds: 400));  // Future 这时才完成
expect(tester.takeException(), isNull);                // 没有崩

如果删掉 if (!mounted) return;,这个测试就会失败:

text
setState() called after dispose(): _AsyncCardState#xxxx(lifecycle state: defunct)

这正是 ch05 那条"await 之后的代码是微任务续体,世界可能已经变了"的具体后果。

④ 外部事件源(TickerCard)

dart
@override
void initState() {
  super.initState();
  _sub = Stream<int>.periodic(widget.period, (int i) => i).listen((int i) {
    if (!mounted) return;
    setState(() => _ticks = i + 1);
  });
}

@override
void dispose() {
  unawaited(_sub?.cancel());   // 不取消 → 定时器永远活着,State 被闭包钉住无法回收
  super.dispose();
}

这是 Dart 版的内存泄漏:Stream.periodic 的 timer → 回调闭包 → State → 整棵子树。GC 管不了这种"活引用",必须手动取消。

6.6 事件处理:从按钮到手势

需求 Widget 备注
按钮 FilledButton / OutlinedButton / IconButton Material 风格;onPressed: null 自动禁用
点击任意区域 GestureDetector(onTap:) 没有水波纹
长按/双击/拖拽 GestureDetector / Draggable ch07 讲拖拽动画
键盘快捷键 Shortcuts + Actions 桌面端必备(Ctrl+S 之类),ch09 会用到
鼠标悬停 MouseRegion / InkWell(onHover:) 桌面端特有的交互

桌面端与移动端的事件差异(本章示例不含手势):桌面上 hover 和高频鼠标事件很常见,移动端则是长按/滑动。跨平台代码里把交互逻辑放在同一层,用 Platform.isAndroid 之类做呈现差异,而不是逻辑差异。

6.7 运行与验证

bash
cd examples/ch06-state
flutter pub get && flutter analyze && flutter test
flutter run -d macos

本次真实验证:

text
No issues found! (ran in 2.0s)
00:00 +10: All tests passed!

✓ Built build/macos/Build/Products/Debug/ch06_state.app
[IMPORTANT:...metal_impeller.mm(53)] Using the Impeller rendering backend (MetalSDF).
flutter: The Dart VM service is listening on http://127.0.0.1:58526/...

界面上四张卡片各自演示一种状态来源;改代码后按 r 热重载,计数器的值不会丢——因为 State 被保留了(这正是 ch02 说的"热重载保留状态")。

附:C/Go 代码对照:状态与重绘

c
/* C / Win32:状态是全局/窗口数据,改完必须自己请求重绘 */
static int g_count = 0;

case WM_COMMAND:
    if (LOWORD(wParam) == ID_INC) {
        g_count++;
        InvalidateRect(hwnd, NULL, TRUE);   // 忘了这行,界面就不会更新
    }
    break;

case WM_PAINT: {
    PAINTSTRUCT ps;
    HDC dc = BeginPaint(hwnd, &ps);
    char buf[32];
    wsprintfA(buf, "count = %d", g_count);
    TextOutA(dc, 10, 10, buf, lstrlenA(buf));
    EndPaint(hwnd, &ps);
    break;
}
dart
// Flutter:状态在 State 字段里,setState 之后框架负责重建与重绘
class _CounterState extends State<Counter> {
  int _count = 0;

  @override
  Widget build(BuildContext context) => Text('count = $_count');

  void bump() => setState(() => _count++);   // 不需要 InvalidateRect
}

差别:Win32 的"数据"和"绘制"是两套手写代码,容易不同步;Flutter 的 build 直接从状态推导 UI,不存在"忘了刷新"——但要守住"build 是纯函数"。

6.8 本章小结 + C/Go 对照清单

主题 C/Go Dart/Flutter 陷阱
状态存放 结构体成员 / 全局变量 State 字段(局部)/ Riverpod(全局) 放全局 → 难测试、难复用
刷新 UI 直接改控件 setState 触发重建 build 里 setState → 死循环
资源释放 free / close dispose() 漏掉 → 泄漏
异步回调 回调 + 上下文指针 await + mounted 检查 setState() called after dispose()
事件订阅 epoll + fd 管理 listen + cancel 漏掉 → State 永不回收
生命周期 手工 init/teardown 框架回调 initState/dispose didChangeDependencies 会多次触发
多事件合批 无 一帧内多次 setState 只重建一次 以为每次 setState 都重建

给 C/Go 老兵的三句话:

  1. Widget 是不可变的配置,State 是活的对象;"状态"永远放 State(或 ch11 的 Provider),别放 Widget。
  2. await 之后的世界已经变了:先 if (!mounted) return;,再碰 setState 和 context。
  3. 凡是"订阅 / controller / 定时器",initState 里建、dispose 里销毁,成对写。

下一章讲动画:AnimatedContainer 这类隐式动画、AnimationController 显式动画,以及"为什么动画也在 dispose 里"。