Flutter中Checkbox组件勾选状态无法正常更新问题咨询

复选框无法响应勾选和运行环境无关，是代码存在三个明确错误：

• 状态变量位置错误：最初将_isChecked定义在build方法内部，每次setState触发UI重建时，build方法会重新执行，该变量会被重置为初始值false，回调中修改的值会被直接覆盖，永远无法生效。
• 语法错误：替换为基础Checkbox组件时，在setState回调中误用相等判断符==代替赋值符=，_isChecked == value仅做无意义的布尔值比较，没有修改变量值，状态自然不会更新。
• 变量遮蔽问题：将_isChecked移为类成员变量后仍不生效，是因为没有清理冗余错误代码：要么build方法内还残留同名的bool _isChecked = false;局部声明，优先级高于类成员变量导致修改无效；要么onChanged回调里还保留着之前的==判断逻辑，没有修正为赋值操作。

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

  @override
  State<SignUpPage> createState() => _SignUpPageState();
}

class _SignUpPageState extends State<SignUpPage> {
  // 状态变量必须定义在State类的成员位置，禁止放在build方法内
  bool _isChecked = false;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text("Sign Up")),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: CheckboxListTile(
          title: const Text('Female'),
          secondary: const Icon(Icons.female),
          controlAffinity: ListTileControlAffinity.leading,
          value: _isChecked,
          onChanged: (value) {
            // 注意使用赋值符=，禁止误用==
            setState(() {
              _isChecked = value ?? false;
            });
          },
        ),
      ),
    );
  }
}

修正上述问题后仍异常的，按以下顺序排查：

• 执行全量热重启（Hot Restart），不要仅用热重载（Hot Reload），类成员变量初始值的修改在热重载时可能不会同步生效。
• 检查Checkbox组件是否被包裹在StatelessWidget中，或是否存在父组件每次重建时重新创建当前页面State的逻辑。
• 检查是否存在其他同名变量在回调执行后覆盖了_isChecked的值。

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