Flutter实现页面initState仅在App首次启动时执行一次

方案1：将初始化逻辑抽离到全局单例类 #

把原本在initState里的代码放到全局单例服务中，确保整个App生命周期内只初始化一次，不受页面导航重建影响。

示例代码：

// 全局初始化服务单例
class PageTwoInitService {
  static final PageTwoInitService _instance = PageTwoInitService._internal();
  bool _hasRunInit = false;

  factory PageTwoInitService() => _instance;

  PageTwoInitService._internal();

  Future<void> runInitLogic() async {
    if (!_hasRunInit) {
      // 这里放原本在initState中的初始化操作
      await Future.delayed(const Duration(milliseconds: 500)); // 模拟异步任务
      _hasRunInit = true;
    }
  }
}

// 页面二的State类
class PageTwoState extends State<PageTwo> {
  @override
  void initState() {
    super.initState();
    // 调用全局服务，初始化逻辑仅执行一次
    PageTwoInitService().runInitLogic();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('页面二')),
      body: const Center(child: Text('页面内容')),
    );
  }
}

方案2：用AutomaticKeepAliveClientMixin保持页面状态 #

让页面二保持在内存中，不随返回操作销毁，这样来回导航不会重建页面，initState自然只执行一次。

示例代码：

class PageTwo extends StatefulWidget {
  const PageTwo({super.key});

  @override
  State<PageTwo> createState() => _PageTwoState();
}

class _PageTwoState extends State<PageTwo> with AutomaticKeepAliveClientMixin {
  @override
  bool get wantKeepAlive => true; // 开启页面保活

  @override
  void initState() {
    super.initState();
    // 此处代码仅在页面首次创建时执行
    print('initState 执行');
  }

  @override
  Widget build(BuildContext context) {
    super.build(context); // 必须调用super.build
    return Scaffold(
      appBar: AppBar(title: const Text('页面二')),
      body: const Center(child: Text('保活状态页面')),
    );
  }
}

注：该方式要求页面通过常规Navigator.push进入，页面栈中会保留实例，返回时仅隐藏而非销毁。

方案3：全局标记初始化状态 #

通过全局变量或状态管理工具标记是否已完成初始化，在initState中判断是否需要执行逻辑。

示例代码（全局变量方式）：

// 全局标记，App启动时默认未初始化
bool _pageTwoHasInited = false;

class PageTwoState extends State<PageTwo> {
  @override
  void initState() {
    super.initState();
    if (!_pageTwoHasInited) {
      // 执行初始化逻辑
      print('首次执行初始化');
      _pageTwoHasInited = true;
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('页面二')),
      body: const Center(child: Text('页面内容')),
    );
  }
}

复杂场景下可改用Provider、GetX等状态管理工具存储标记，更利于维护。

方案4：复用页面实例 #

在全局或页面一中提前创建页面二的实例，导航时直接复用该实例，避免每次导航都创建新对象。

示例代码：

// 在页面一或全局位置保存页面二的实例
final PageTwo _pageTwoInstance = const PageTwo();

// 页面一中的导航逻辑
Navigator.push(context, MaterialPageRoute(builder: (_) => _pageTwoInstance));

这种方式下页面二仅在首次创建实例时执行initState，后续导航复用同一实例，不会重复触发。

内容的提问来源于stack exchange，提问作者Faizan Abbas Bangash