Flutter：如何在运行时以编程方式更改自定义Stateful Widget状态？

方法一：改成受控组件模式（推荐） #

把单选组的选中状态从内部State移到父组件中，通过Widget构造参数传入当前选中值，同时暴露onChanged回调让父组件更新状态，完全符合Flutter状态管理的最佳实践。

示例代码：

class RadioButtonGroup extends StatelessWidget {
  final String selectedValue;
  final List<String> options;
  final Function(String) onChanged;

  const RadioButtonGroup({
    super.key,
    required this.selectedValue,
    required this.options,
    required this.onChanged,
  });

  @override
  Widget build(BuildContext context) {
    return Row(
      children: options.map((option) {
        return ElevatedButton(
          style: ElevatedButton.styleFrom(
            backgroundColor: selectedValue == option ? Colors.blue : null,
          ),
          onPressed: () => onChanged(option),
          child: Text(option),
        );
      }).toList(),
    );
  }
}

// 父组件使用示例
class ParentWidget extends StatefulWidget {
  @override
  State<ParentWidget> createState() => _ParentWidgetState();
}

class _ParentWidgetState extends State<ParentWidget> {
  String _selectedOption = 'option1';

  // 编程式切换选中项的方法
  void switchToOption2() {
    setState(() {
      _selectedOption = 'option2';
    });
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        RadioButtonGroup(
          selectedValue: _selectedOption,
          options: ['option1', 'option2', 'option3'],
          onChanged: (value) {
            setState(() {
              _selectedOption = value;
            });
          },
        ),
        TextButton(
          onPressed: switchToOption2,
          child: const Text('切换到option2'),
        ),
      ],
    );
  }
}

优点：父子组件状态边界清晰，避免直接操作内部State，可维护性强，后续扩展更方便。

方法二：用GlobalKey获取内部State对象 #

如果要保留Widget内部的状态管理逻辑，可以通过GlobalKey获取State实例，调用内部暴露的方法更新选中状态。注意这种方式要谨慎使用，避免破坏Flutter的状态流转逻辑。

示例代码：

class RadioButtonGroup extends StatefulWidget {
  final List<String> options;
  RadioButtonGroup({
    required this.options,
    required super.key,
  });

  @override
  RadioButtonGroupState createState() => RadioButtonGroupState();
}

class RadioButtonGroupState extends State<RadioButtonGroup> {
  late String _selectedValue;

  @override
  void initState() {
    super.initState();
    _selectedValue = widget.options.first;
  }

  // 暴露给外部调用的更新方法
  void setSelectedValue(String value) {
    if (widget.options.contains(value)) {
      setState(() {
        _selectedValue = value;
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Row(
      children: widget.options.map((option) {
        return ElevatedButton(
          style: ElevatedButton.styleFrom(
            backgroundColor: _selectedValue == option ? Colors.blue : null,
          ),
          onPressed: () => setSelectedValue(option),
          child: Text(option),
        );
      }).toList(),
    );
  }
}

// 父组件使用示例
class ParentWidget extends StatefulWidget {
  @override
  State<ParentWidget> createState() => _ParentWidgetState();
}

class _ParentWidgetState extends State<ParentWidget> {
  final _radioGroupKey = GlobalKey<RadioButtonGroupState>();

  void switchToOption2() {
    _radioGroupKey.currentState?.setSelectedValue('option2');
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        RadioButtonGroup(
          key: _radioGroupKey,
          options: ['option1', 'option2', 'option3'],
        ),
        TextButton(
          onPressed: switchToOption2,
          child: const Text('切换到option2'),
        ),
      ],
    );
  }
}

方法三：用ValueNotifier管理状态 #

将选中状态用ValueNotifier存储，Widget内部通过ValueListenableBuilder监听状态变化，外部可以直接修改ValueNotifier的值来更新选中状态，无需StatefulWidget。

示例代码：

class RadioButtonGroup extends StatelessWidget {
  final ValueNotifier<String> selectedValueNotifier;
  final List<String> options;

  const RadioButtonGroup({
    super.key,
    required this.selectedValueNotifier,
    required this.options,
  });

  @override
  Widget build(BuildContext context) {
    return ValueListenableBuilder<String>(
      valueListenable: selectedValueNotifier,
      builder: (context, selectedValue, child) {
        return Row(
          children: options.map((option) {
            return ElevatedButton(
              style: ElevatedButton.styleFrom(
                backgroundColor: selectedValue == option ? Colors.blue : null,
              ),
              onPressed: () => selectedValueNotifier.value = option,
              child: Text(option),
            );
          }).toList(),
        );
      },
    );
  }
}

// 父组件使用示例
class ParentWidget extends StatefulWidget {
  @override
  State<ParentWidget> createState() => _ParentWidgetState();
}

class _ParentWidgetState extends State<ParentWidget> {
  final _selectedValueNotifier = ValueNotifier<String>('option1');

  void switchToOption2() {
    _selectedValueNotifier.value = 'option2';
  }

  @override
  void dispose() {
    _selectedValueNotifier.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        RadioButtonGroup(
          selectedValueNotifier: _selectedValueNotifier,
          options: ['option1', 'option2', 'option3'],
        ),
        TextButton(
          onPressed: switchToOption2,
          child: const Text('切换到option2'),
        ),
      ],
    );
  }
}

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