适用版本
原文发布于 2022 年;保留空安全写法,删除非空安全旧模板。
StatefulWidget 的页面模板应保持简单:参数属于 Widget,可变状态与控制器属于 State;初始化和释放成对出现。
普通页面模板
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,再更新界面。
保留懒加载页面的状态
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、控制器和订阅仍需释放。


