跨平台开发 / 系统课时
看懂 initState 和 dispose
看懂 initState 和 dispose
本篇解决 Flutter StatefulWidget 中初始化资源和释放资源的问题。你将理解 initState 与 dispose 的调用时机,并学会正确管理 controller、focus 等需要生命周期维护的对象。
学习目标
- 理解 State 对象生命周期中 initState 和 dispose 的职责
- 掌握在正确位置创建和释放控制器类资源
- 避免因为资源未释放导致的内存占用和异常行为
StatefulWidget 的生命周期职责
Flutter 中 StatefulWidget 的状态由 State 对象管理。State 创建后不会立即参与界面更新,而是经历初始化、构建、更新和销毁等阶段。
initState 用于执行一次性的初始化逻辑,例如创建 TextEditingController、AnimationController、FocusNode 或订阅外部数据源。它只会在当前 State 第一次插入组件树时调用一次。
dispose 则负责释放 State 不再需要的资源。当组件从树中移除并且 State 永远不会再次使用时,Flutter 会调用 dispose。

在 initState 中创建资源
需要跟随页面生命周期存在的对象,通常应该在 initState 中创建,而不是直接写在 build 方法里。
build 可能因为状态变化多次执行,如果在 build 中不断创建 controller,会导致重复分配资源,并可能产生监听重复绑定的问题。
下面是一个管理输入框控制器的完整示例:
import 'package:flutter/material.dart';
void main() {
runApp(const MaterialApp(home: ProfilePage()));
}
class ProfilePage extends StatefulWidget {
const ProfilePage({super.key});
@override
State<ProfilePage> createState() => _ProfilePageState();
}
class _ProfilePageState extends State<ProfilePage> {
late final TextEditingController nameController;
@override
void initState() {
super.initState();
// 控制器只创建一次,与当前 State 生命周期绑定
nameController = TextEditingController(text: 'Flutter');
}
@override
void dispose() {
// 页面销毁前释放输入控制器资源
nameController.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Scaffold(
body: Padding(
padding: const EdgeInsets.all(16),
child: TextField(controller: nameController),
),
);
}
}预期输出
应用启动后显示输入框,默认文本为 Flutter。
页面销毁时 TextEditingController 被释放,不继续占用资源。dispose 中常见释放对象
不是所有字段都需要 dispose。通常只有继承自 ChangeNotifier、持有系统资源或注册监听的对象需要主动释放。
| 对象 | 是否需要 dispose | 原因 |
|---|---|---|
| TextEditingController | 需要 | 内部维护输入状态和监听 |
| FocusNode | 需要 | 持有焦点管理资源 |
| AnimationController | 需要 | 管理动画 ticker |
| 普通 String、int | 不需要 | Dart 垃圾回收自动处理 |
如果对象需要释放,应保证释放顺序合理。通常先取消自己的监听,再调用父类 dispose。
initState 和 build 的边界
很多生命周期问题来自职责混淆。build 应该描述当前界面如何渲染,而 initState 应该完成一次性准备工作。
例如网络请求、控制器初始化、监听注册等操作通常不应该直接放入 build,否则每次重新构建界面都可能重复执行。
当组件依赖父组件传入参数,并且参数变化需要重新处理时,可以结合 didUpdateWidget,而不是重复利用 initState。initState 只处理首次初始化场景。