c.ShouldBind无法直接获取checkbox布尔值，因未勾选时浏览器不提交字段，导致结构体字段保持零值而无法区分“未勾选”与“未提交”。
为什么 c.ShouldBind 无法直接获取 checkbox 的布尔值
因为 HTML 中未勾选的 checkbox 标签根本不会提交任何字段到后端，浏览器只发送已勾选项（如 agree=on 或 roles=admin），所以 Gin 的 c.ShouldBind 绑定结构体时，对应字段会保持零值（false 或空切片），但你无法区分“用户没勾选”和“用户压根没提交这个字段”。这导致逻辑误判——比如把“未同意协议”当成“默认同意”。
用 c.PostFormArray 显式判断 checkbox 是否提交
这是最可控、无歧义的方式：不依赖结构体绑定，而是手动读取原始表单字段。适用于所有 checkbox 场景，尤其是多选（如权限、标签）或单个布尔开关（如是否启用）。
常见做法：
- 对单个 checkbox（如
），用c.PostForm("is_active")—— 有值返回"on"（或自定义 value），无值返回空字符串 - 对多个同名 checkbox（如
），用c.PostFormArray("role")—— 返回已勾选项组成的[]string，未勾选则为空切片 - 别用
c.DefaultPostForm填默认值，它会掩盖“未提交”这个关键信号
结构体绑定 + 自定义 Unmarshaler 的边界方案
如果你坚持用 c.ShouldBind，必须让结构体字段能表达“未提交”状态，即使用指针或自定义类型。原生 bool 不行，因为它无法区分零值与未提交。
示例（安全写法）：
type FormData struct {
Agree *bool `form:"agree"`
}
// 处理逻辑：
if form.Agree == nil {
// 字段未提交 → 用户没操作该 checkbox
} else if *form.Agree {
// 明确勾选了
} else {
// 明确取消勾选（仅当 HTML 中设置了 value="false" 且用户取消时才可能，极少见）
}
⚠️ 注意：Agree *bool 只能捕获“是否提交”，不能自动转 "on" → true；仍需在 UnmarshalJSON / UnmarshalForm 中手动处理， Gin 默认不支持这种转换，容易漏掉。
HTML checkbox 的 value 属性必须显式设置
很多开发者忽略这点：不设 value 时，浏览器默认提交 "on"，但后端解析时若期望 "true" 或 "1" 就会失败。尤其涉及数据库布尔字段或下游 API 时，硬编码依赖 "on" 风险高。
建议统一约定：
- 单个开关：用
，后端按字符串比较c.PostForm("notify") == "true" - 多选列表：每个
value应为语义明确的标识符，如value="read"、value="write"，避免数字或"on" - 禁止省略
value—— 它不是可选的，是数据契约的一部分
真正麻烦的不是怎么取值，而是如何定义“未提交”这个状态在业务里代表什么。前端漏传、网络截断、用户禁用 JS 都可能导致字段缺失，所以服务端永远要为 nil 或空做显式分支，而不是靠默认值掩盖问题。
