Flutter 页面模板:State 生命周期与状态保留

整理空安全 StatefulWidget 模板,说明控制器释放和 keep-alive 的适用范围。

适用版本

原文发布于 2022 年;保留空安全写法,删除非空安全旧模板。

本文目录
  1. 普通页面模板
  2. 保留懒加载页面的状态
  3. 参考

StatefulWidget 的页面模板应保持简单:参数属于 Widget,可变状态与控制器属于 State;初始化和释放成对出现。

普通页面模板

dart
import 'package:flutter/material.dart';

class ExamplePage extends StatefulWidget {
  const ExamplePage({super.key, required this.title});
  final String title;

  @override
  State<ExamplePage> createState() => _ExamplePageState();
}

class _ExamplePageState extends State<ExamplePage> {
  final _textController = TextEditingController();

  @override
  void initState() {
    super.initState();
    // 初始化本页面拥有的状态和订阅。
  }

  @override
  void dispose() {
    _textController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text(widget.title)),
      body: SafeArea(
        child: Padding(
          padding: const EdgeInsets.all(16),
          child: TextField(controller: _textController),
        ),
      ),
    );
  }
}

页面参数尽量声明为具体类型,避免把所有参数都装进无类型 Map。异步操作返回后,先确认 State 仍然 mounted,再更新界面。

保留懒加载页面的状态

dart
class _TabPageState extends State<TabPage>
    with AutomaticKeepAliveClientMixin<TabPage> {
  @override
  bool get wantKeepAlive => true;

  @override
  Widget build(BuildContext context) {
    super.build(context);
    return const Center(child: Text('标签页内容'));
  }
}

这段写法适用于有相应 AutomaticKeepAlive 祖先的懒构建子项,例如部分分页或列表结构。super.build(context) 负责通知保活机制,返回值不作为页面内容使用。wantKeepAlive 动态变化时调用 updateKeepAlive()。

保活不会把路由永久保存到磁盘,也不会阻止用户关闭页面。需要跨启动恢复的数据,应由持久化或状态恢复机制处理。页面真正销毁时,自己的 Timer、控制器和订阅仍需释放。

参考

作者:NeverOuO。原载 NeverOuO 个人小站,现收录于云屿来文章与教程。

返回全部文章

把好用的工具分享给朋友

分享

发送链接,让朋友直接打开这个页面。

访问统计

我们统计页面浏览、渠道来源、产品入口点击与分享次数,用于了解产品如何被发现。这项统计不使用用户标识、Cookie 或跨站追踪,也不读取上传文件或表单内容。