如何在StatefulWidget类内部获取对应的State<>实例？

当然可以实现这个需求，下面提供两种常用方案，你可以根据场景选择：

方案一：通过WeakReference持有State引用（Widget内部访问优先） #

这种方式无需额外传参，直接在Widget内部维护State的弱引用，避免内存泄漏：

class Foo extends StatefulWidget {
  Foo({super.key});

  WeakReference<_FooState>? _stateRef;

  int get bar {
    final state = _stateRef?.target;
    if (state == null) {
      throw StateError('Foo的State未初始化或已被销毁');
    }
    return state.bar;
  }

  @override
  State<Foo> createState() {
    final state = _FooState();
    _stateRef = WeakReference(state);
    return state;
  }
}

class _FooState extends State<Foo> {
  int bar = 42;

  @override
  Widget build(BuildContext context) {
    return Container();
  }
}

注意事项： #

• 使用WeakReference是因为State的生命周期由Flutter框架管控，弱引用不会阻止State被垃圾回收，能避免内存泄漏问题。
• 访问bar getter时必须判空，因为State可能已经被销毁（比如Widget从树中移除后），此时可根据业务需求抛出错误或返回默认值。

方案二：通过GlobalKey访问State（外部访问优先） #

如果需要在Widget实例外部也能访问其State，GlobalKey是更合适的选择：

class Foo extends StatefulWidget {
  Foo({super.key, this.stateKey = const GlobalKey<_FooState>()});

  final GlobalKey<_FooState> stateKey;

  int get bar => stateKey.currentState!.bar;

  @override
  State<Foo> createState() => _FooState();
}

class _FooState extends State<Foo> {
  int bar = 42;

  @override
  Widget build(BuildContext context) {
    return Container();
  }
}

使用方式： #

// 创建Widget时传入GlobalKey
final fooKey = GlobalKey<_FooState>();
final fooWidget = Foo(stateKey: fooKey);

// 访问State中的bar
print(fooWidget.bar);
// 或者直接通过key访问
print(fooKey.currentState?.bar);

注意事项： #

• GlobalKey必须保证全局唯一，不能同一个key被多个Widget实例使用，否则会引发框架异常。
• 当Widget被从Widget树中移除后，currentState会变为null，访问时需要做判空处理，避免空指针异常。

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