如何从Flutter另一个StatefulWidget的State访问变量数据？

为什么GlobalKey访问State变量会返回null？ #

你遇到的currentState为null的情况，大概率是这几个原因：

• GlobalKey没正确绑定到目标Widget：必须把定义好的GlobalKey传给目标StatefulWidget的构造函数，不然Key和Widget实例没有关联，自然拿不到State。
• 访问时机太早：比如在initState里直接调用currentState，这时候Widget还没完成挂载，State还没初始化，返回null是正常的。
• 目标Widget已被销毁：如果目标Widget已经从Widget树中移除，currentState也会变成null。

正确使用GlobalKey的示例 #

// 定义GlobalKey，注意要指定State的泛型类型
final GlobalKey<_TargetWidgetState> targetKey = GlobalKey();

// 目标StatefulWidget
class TargetWidget extends StatefulWidget {
  const TargetWidget({super.key}); // 接收外部传的key

  @override
  State<TargetWidget> createState() => _TargetWidgetState();
}

class _TargetWidgetState extends State<TargetWidget> {
  String myVariable = "需要访问的变量";

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

// 在其他Widget中使用并访问
class OtherWidget extends StatelessWidget {
  const OtherWidget({super.key});

  @override
  Widget build(BuildContext context) {
    return ElevatedButton(
      onPressed: () {
        // 确保Widget已挂载，用?避免空指针
        String? value = targetKey.currentState?.myVariable;
        print(value);
      },
      child: const Text("获取变量"),
    );
  }
}

// 页面中要把Key传给TargetWidget
@override
Widget build(BuildContext context) {
  return Column(
    children: [
      TargetWidget(key: targetKey), // 绑定Key
      const OtherWidget(),
    ],
  );
}

更合适的实现方案 #

直接用GlobalKey访问State变量违反了Flutter的状态封装原则，会让组件耦合度变高，后期维护麻烦。更推荐这几种方式：

1. 回调函数（父子组件场景） #

如果两个Widget是父子关系，通过回调函数传递数据是最直接的方式：

// 子组件（持有变量）
class ChildWidget extends StatefulWidget {
  final Function(String) onVariableUpdate;
  const ChildWidget({super.key, required this.onVariableUpdate});

  @override
  State<ChildWidget> createState() => _ChildWidgetState();
}

class _ChildWidgetState extends State<ChildWidget> {
  String _innerVariable = "初始值";

  void _updateVariable() {
    setState(() {
      _innerVariable = "更新后的值";
    });
    // 调用回调通知父组件
    widget.onVariableUpdate(_innerVariable);
  }

  @override
  Widget build(BuildContext context) {
    return ElevatedButton(
      onPressed: _updateVariable,
      child: Text(_innerVariable),
    );
  }
}

// 父组件（需要访问变量）
class ParentWidget extends StatefulWidget {
  const ParentWidget({super.key});

  @override
  State<ParentWidget> createState() => _ParentWidgetState();
}

class _ParentWidgetState extends State<ParentWidget> {
  String _childVariable = "";

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        ChildWidget(
          onVariableUpdate: (value) {
            setState(() {
              _childVariable = value;
            });
          },
        ),
        Text("子组件的变量：$_childVariable"),
      ],
    );
  }
}

2. ValueNotifier（轻量级跨组件共享） #

如果是简单的单个变量共享，用ValueNotifier足够，不用引入复杂的状态管理库：

// 全局定义ValueNotifier（也可以放在父组件中传递）
final sharedVariable = ValueNotifier<String>("初始值");

// 持有变量并更新的Widget
class VariableHolder extends StatefulWidget {
  const VariableHolder({super.key});

  @override
  State<VariableHolder> createState() => _VariableHolderState();
}

class _VariableHolderState extends State<VariableHolder> {
  @override
  Widget build(BuildContext context) {
    return ElevatedButton(
      onPressed: () {
        sharedVariable.value = "新的值";
      },
      child: ValueListenableBuilder(
        valueListenable: sharedVariable,
        builder: (context, value, child) {
          return Text(value);
        },
      ),
    );
  }
}

// 访问变量的Widget
class VariableAccess extends StatelessWidget {
  const VariableAccess({super.key});

  @override
  Widget build(BuildContext context) {
    return ValueListenableBuilder(
      valueListenable: sharedVariable,
      builder: (context, value, child) {
        return Text("共享变量：$value");
      },
    );
  }
}

3. 状态管理库（复杂场景） #

如果项目中有大量跨组件的状态共享需求，推荐用Riverpod、Provider或者Bloc这类状态管理库，它们能更规范地管理状态，降低组件耦合。

内容的提问来源于stack exchange，提问作者Abdul Haadi Alhassan