如何在Flutter中实现SwiftUI StateObject语义并避免对象重复实例化

一、避免每次状态变化重建对象实例 #

要避免StatefulWidget状态变化时重新创建对象，核心是将对象实例放在State类中而非build方法内——State实例的生命周期与Widget绑定，只要Widget未从Widget树中移除，State就会保持存活，不会随build调用重新初始化。

1. 直接在State中初始化对象 #

如果对象不需要依赖Widget参数，直接在State中声明并初始化：

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

  @override
  State<MyWidget> createState() => _MyWidgetState();
}

class _MyWidgetState extends State<MyWidget> {
  // 仅初始化一次，不会随build重建
  final MyService _myService = MyService();

  @override
  Widget build(BuildContext context) {
    return Text(_myService.someValue);
  }
}

2. 依赖Widget参数的初始化 #

如果对象需要用Widget的参数初始化，使用initState完成首次初始化；若参数更新需重建对象，再通过didUpdateWidget处理：

class _MyWidgetState extends State<MyWidget> {
  late MyService _myService;

  @override
  void initState() {
    super.initState();
    // 首次初始化
    _myService = MyService(initialValue: widget.initialValue);
  }

  @override
  void didUpdateWidget(covariant MyWidget oldWidget) {
    super.didUpdateWidget(oldWidget);
    // 仅当参数变化时才重建对象
    if (oldWidget.initialValue != widget.initialValue) {
      _myService = MyService(initialValue: widget.initialValue);
    }
  }

  @override
  Widget build(BuildContext context) {
    return Text(_myService.someValue);
  }
}

3. 异步初始化场景 #

若对象需要异步初始化，将Future对象放在State中，避免在build内重复发起异步操作：

class _MyWidgetState extends State<MyWidget> {
  late final Future<MyService> _serviceFuture;

  @override
  void initState() {
    super.initState();
    // 仅执行一次异步初始化
    _serviceFuture = MyService.initAsync();
  }

  @override
  Widget build(BuildContext context) {
    return FutureBuilder<MyService>(
      future: _serviceFuture,
      builder: (context, snapshot) {
        if (snapshot.hasData) {
          return Text(snapshot.data!.someValue);
        } else {
          return const CircularProgressIndicator();
        }
      },
    );
  }
}

二、实现SwiftUI StateObject的语义 #

SwiftUI的StateObject用于持有可观察对象，确保对象与视图生命周期绑定、仅初始化一次，且能触发UI更新。在Flutter中，可通过State类持有可观察对象 + 监听状态变化的Widget实现等价语义：

1. 定义可观察对象 #

使用ChangeNotifier（或ValueNotifier）创建可观察的业务类：

class MyViewModel extends ChangeNotifier {
  int _count = 0;
  int get count => _count;

  void increment() {
    _count++;
    // 通知监听者更新UI
    notifyListeners();
  }
}

2. 在State中持有对象并监听变化 #

用ListenableBuilder（或Consumer，若使用Provider）监听对象变化，确保UI随状态更新：

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

  @override
  State<MyWidget> createState() => _MyWidgetState();
}

class _MyWidgetState extends State<MyWidget> {
  // 等价于StateObject，仅初始化一次
  final MyViewModel _viewModel = MyViewModel();

  @override
  Widget build(BuildContext context) {
    return ListenableBuilder(
      listenable: _viewModel,
      builder: (context, child) {
        return Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('当前计数: ${_viewModel.count}'),
            ElevatedButton(
              onPressed: _viewModel.increment,
              child: const Text('增加'),
            ),
          ],
        );
      },
    );
  }
}

补充：跨Widget共享场景 #

如果需要在多个Widget间共享该对象（类似SwiftUI的ObservedObject），可以使用Provider或Riverpod等状态管理库，但单个视图内的私有对象，用State持有就完全对应StateObject的核心语义：对象生命周期与视图绑定，不随build重建，且能驱动UI更新。

内容的提问来源于stack exchange，提问作者funkybro