跨平台开发 / 系统课时
用 StatefulWidget 管理页面变化
用 StatefulWidget 管理页面变化
本篇解决 Flutter 页面需要保存并修改数据时如何组织代码的问题。你将理解 StatefulWidget 与 State 的职责划分,并通过一个简单计数页面掌握可变状态驱动界面更新的基本方式。
学习目标
- 理解 StatefulWidget、State 和 Widget 重建之间的关系。
- 掌握 State 对象保存页面可变数据的方法。
- 能够编写一个包含用户交互和状态变化的简单页面。
为什么需要 StatefulWidget
Flutter 中普通的 Widget 通常被设计为不可变对象。Widget 描述的是界面配置,而不是长期保存的数据。当页面内容需要随着用户操作、网络结果或计时器发生变化时,就需要额外的状态管理机制。
StatefulWidget 提供了一种把界面描述和可变数据分开的方式。StatefulWidget 本身仍然保持不可变,真正保存变化数据的是对应的 State 对象。
例如,一个计数按钮页面中,当前数字属于页面状态,而按钮和文本属于界面描述。当数字变化时,Flutter 会根据新的状态重新构建相关 Widget。
StatefulWidget 与 State 的关系
StatefulWidget 负责创建 State,并描述这个页面属于哪一种组件。State 负责保存数据、响应事件以及通知 Flutter 页面需要重新构建。

常见职责划分如下:
| 对象 | 主要职责 |
|---|---|
| StatefulWidget | 保存初始化配置,创建 State |
| State | 保存可变数据,执行状态变化逻辑 |
| build 方法 | 根据当前状态生成 Widget 树 |
一个页面通常通过继承 StatefulWidget 创建组件,再通过 State 类保存需要变化的数据。
创建一个 StatefulWidget 页面
下面示例创建一个简单计数器。点击按钮时,状态中的数字增加,页面重新构建后显示最新结果。
import 'package:flutter/material.dart';
class CounterPage extends StatefulWidget {
const CounterPage({super.key});
@override
State<CounterPage> createState() => _CounterPageState();
}
class _CounterPageState extends State<CounterPage> {
int count = 0;
void increment() {
setState(() {
// 修改状态后通知 Flutter 重新执行 build。
count++;
});
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: const Text('Counter')),
body: Center(
child: Text('count: $count'),
),
floatingActionButton: FloatingActionButton(
onPressed: increment,
child: const Icon(Icons.add),
),
);
}
}预期结果
页面显示 count: 0。
每点击一次按钮,数字增加 1,页面显示最新 count 值。这里的关键点不是数字累加本身,而是状态变化流程:用户操作修改 State 中的数据,然后 Flutter 根据新的状态重新执行 build。
State 管理中的常见边界
State 适合保存当前页面自身需要维护的数据,例如输入框内容、选中状态、动画进度或加载状态。但如果多个页面共享同一份数据,仅依赖单个 State 会让数据传递变得复杂。
当状态影响范围扩大时,可以考虑使用更高层的状态管理方案,例如 Provider、Riverpod 或其他架构方式。
同时需要注意,State 中保存的数据应该代表页面状态,而不是临时计算结果。能够通过其他数据直接计算出来的内容,通常不需要额外保存。
什么时候使用 StatefulWidget
当页面存在明确的变化来源时,可以优先考虑 StatefulWidget,例如:
- 用户点击按钮改变页面内容。
- 输入框内容需要实时显示。
- 页面需要根据异步请求结果刷新。
- 动画过程需要持续更新。
如果页面完全由固定数据生成,没有交互变化,则 StatelessWidget 会更简单,也更容易维护。