CheckBox仅表达选中/未选中状态，不执行即时操作；WinForms用Checked（bool），WPF/WinUI用IsChecked（bool?支持三态）；启用ThreeState后需手动处理CheckedChanged事件；批量读取应遍历容器子控件或绑定数据源；禁用以CheckBox直接触发副作用，应统一收口至提交动作。
CheckBox 不是用来“开关操作”的，它只表达状态；选中/未选中是它的核心语义，强行让它执行即时动作或模拟三态业务逻辑，八成会出 bug。
CheckBox 的 Checked 和 IsChecked 到底该用哪个？
取决于你用的是 WinForms 还是 WPF/UWP/WinUI：
- WinForms：用
Checked（bool?类型不可用），读写都直接访问checkBox1.Checked - WPF / WinUI 3：必须用
IsChecked（bool?类型），因为它支持三态：true、false、null（对应Indeterminate） - 别混用：在 WinForms 中写
checkBox1.IsChecked会编译报错；在 WPF 中硬写Checked属性根本不存在
为什么 ThreeState = true 后点击没反应？
因为启用三态后，Click 事件不再自动切换状态——系统把控制权交给你了。默认点击行为被禁用，否则无法区分“用户点一下想设为 null”还是“点一下想设为 true”。
- 必须手动处理
CheckedChanged事件，并在其中判断当前IsChecked值来决定下一步状态 - 常见错误：只监听
Click，结果点了没变化，还以为控件坏了 - 正确做法示例（WPF）：
private void CheckBox_Checked(object sender, RoutedEventArgs e) { var cb = sender as CheckBox; if (cb.IsChecked == true) cb.IsChecked = false; else if (cb.IsChecked == false) cb.IsChecked = null; else cb.IsChecked = true; }
批量读取多个 CheckBox 状态时，别硬写 7 个 if (cbX.Checked)
这种写法不仅难维护，还容易漏掉新添加的复选框，更关键的是：它把 UI 控件和业务逻辑死绑在一起，后续加校验、改文案、换布局都会牵一发而动全身。
- 推荐用容器组织（如
Panel或StackPanel），然后遍历子控件：var selected = panel1.Controls.OfType<CheckBox>() .Where(cb => cb.Checked) .Select(cb => cb.Text) .ToArray(); - WinForms 中注意：若 CheckBox 是直接拖到窗体上，需用
this.Controls；若放在 GroupBox 内，则用groupBox1.Controls - 更健壮的做法是绑定数据源（比如
BindingList<optionitem></optionitem>），让CheckBox的DataContext或DataBindings关联属性，而不是靠控件名硬编码
千万别用 CheckBox 实现“启用/禁用某功能”的即时开关
这是最常被踩的坑：用户点一下复选框，立刻调用 StartService() 或 SaveConfig()。问题在于——复选框本身不承诺“操作即刻生效”，它只是个状态快照。
- 用户可能勾选后又取消，中间触发了两次副作用，但实际什么都没发生
- 表单提交前要校验，你却在每次点击都保存，导致脏数据写入
- 正确姿势：把 CheckBox 当作“意愿标记”，所有副作用统一收口到提交动作里（比如按钮
Click或表单Validating事件） - 如果真需要即时响应（如预览开关），请换用
ToggleButton（WPF）或Switch（WinUI），它们的设计契约就是“操作优先”
三态逻辑、事件绑定时机、状态与行为的边界——这些地方不细看文档很容易按直觉写错，而且 bug 表现得非常隐蔽：有时候能动，有时候不动，调试时断点进了又出不来。多花两分钟确认控件的设计意图，比花两小时追状态同步问题划算得多。
