Flutter 交互与状态:StatefulWidget、setState、生命周期
第 6 章 · Flutter 交互与状态:StatefulWidget、setState、生命周期
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 三大经典运行时错误:setState() called after dispose()- 忘记
cancel订阅 /disposecontroller - 在
build里发起副作用(请求、改状态)
- 会写 widget 测试覆盖"交互 → 状态变化 → UI 更新"这条链路。
6.2 StatefulWidget 与 State:谁存状态
// 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:告诉框架"这个子树需要重建"
void bump(int delta) => setState(() => _count += delta * widget.step);
规则:
setState里只做同步的状态修改,不要await;- 改完状态后框架会把该
State标脏,在下一帧重建这个 State 的 build 子树; - 同一帧内多次
setState只重建一次(框架合批),实测:
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 生命周期:一张图背完
createState()
└─ initState() ← 只调用一次;初始化 controller / 发起首次请求 / 订阅
└─ didChangeDependencies()← initState 之后;依赖的 InheritedWidget 变化时再次触发
└─ build() ← 每次需要重绘都会调用,可能非常频繁
├─ didUpdateWidget(oldWidget) ← 父级传了新配置(State 复用)
└─ deactivate() → dispose() ← 移出树;这里释放一切资源
示例里的 LifecycleProbe 把每个回调记进列表,测试断言了真实顺序:
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 是有生命周期的资源(它连着原生输入法、选区、监听器):
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)
@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 完成前被销毁"的场景:
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;,这个测试就会失败:
setState() called after dispose(): _AsyncCardState#xxxx(lifecycle state: defunct)
这正是 ch05 那条"await 之后的代码是微任务续体,世界可能已经变了"的具体后果。
④ 外部事件源(TickerCard)
@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 运行与验证
cd examples/ch06-state
flutter pub get && flutter analyze && flutter test
flutter run -d macos
本次真实验证:
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 / 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;
}
// 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 老兵的三句话:
Widget是不可变的配置,State是活的对象;"状态"永远放State(或 ch11 的 Provider),别放 Widget。await之后的世界已经变了:先if (!mounted) return;,再碰setState和context。- 凡是"订阅 / controller / 定时器",
initState里建、dispose里销毁,成对写。
下一章讲动画:AnimatedContainer 这类隐式动画、AnimationController 显式动画,以及"为什么动画也在 dispose 里"。