跨平台开发 / 系统课时

看懂 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。

State 生命周期中初始化与释放资源关系示意图

在 initState 中创建资源

需要跟随页面生命周期存在的对象,通常应该在 initState 中创建,而不是直接写在 build 方法里。

build 可能因为状态变化多次执行,如果在 build 中不断创建 controller,会导致重复分配资源,并可能产生监听重复绑定的问题。

下面是一个管理输入框控制器的完整示例:

dart
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),
      ),
    );
  }
}

预期输出

text
应用启动后显示输入框,默认文本为 Flutter。
页面销毁时 TextEditingController 被释放,不继续占用资源。

dispose 中常见释放对象

不是所有字段都需要 dispose。通常只有继承自 ChangeNotifier、持有系统资源或注册监听的对象需要主动释放。

对象 是否需要 dispose 原因
TextEditingController 需要 内部维护输入状态和监听
FocusNode 需要 持有焦点管理资源
AnimationController 需要 管理动画 ticker
普通 String、int 不需要 Dart 垃圾回收自动处理

如果对象需要释放,应保证释放顺序合理。通常先取消自己的监听,再调用父类 dispose。

initState 和 build 的边界

很多生命周期问题来自职责混淆。build 应该描述当前界面如何渲染,而 initState 应该完成一次性准备工作。

例如网络请求、控制器初始化、监听注册等操作通常不应该直接放入 build,否则每次重新构建界面都可能重复执行。

当组件依赖父组件传入参数,并且参数变化需要重新处理时,可以结合 didUpdateWidget,而不是重复利用 initState。initState 只处理首次初始化场景。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

看懂 initState 和 dispose

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通