Flutter Checkbox点击后onChanged执行但不显示勾选状态

以下是几种常见的原因和对应的排查方法：

• 状态未与Checkbox的value绑定同步
  核心问题大概率是Checkbox的value属性没有关联到实时更新的状态。比如用StatefulWidget时，没在状态变化时调用setState()；用Riverpod这类状态管理库时，错误地用ref.read()获取状态（应该用ref.watch()来监听状态变化，触发Widget重建）。
  举个简单的正确示例（StatefulWidget）：

  class _MyPageState extends State<MyPage> {
    bool _isChecked = false;
  
    @override
    Widget build(BuildContext context) {
      return Scaffold(
        body: Checkbox(
          value: _isChecked,
          onChanged: (bool? newValue) {
            setState(() {
              _isChecked = newValue ?? false;
            });
          },
        ),
      );
    }
  }
  

• 主题样式覆盖了勾选视觉效果
  检查全局或局部的CheckboxTheme配置，可能fillColor（勾选后的填充色）或checkColor（勾选标记颜色）被设置成了和背景接近的颜色，导致看不见勾选状态。可以临时给Checkbox套一个独立Theme测试：

  Theme(
    data: ThemeData(
      checkboxTheme: CheckboxThemeData(
        fillColor: MaterialStateProperty.resolveWith((states) {
          return states.contains(MaterialState.selected) ? Colors.blue : null;
        }),
        checkColor: MaterialStateProperty.all(Colors.white),
      ),
    ),
    child: Checkbox(
      value: yourCheckedValue,
      onChanged: (val) {
        // 状态更新逻辑
      },
    ),
  )
  

• 父Widget阻止了UI重建
  看看Checkbox的父级有没有用const修饰，或者使用了AutomaticKeepAliveClientMixin但未正确处理，导致状态变化时父Widget没有重建，Checkbox自然不会更新显示。

• 状态更新逻辑存在隐性问题
  虽然你说onChanged能拿到true，但要确认状态变量确实被正确更新了。比如在状态管理中，是否有其他逻辑在悄悄重置这个值？可以在onChanged回调里打印状态变量的最新值，验证更新是否生效。

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