在 Go 的 JSON 序列化中，bool 类型无法区分“未设置”和“显式设为 false”，导致 API 默认值逻辑失效；使用 *bool（布尔指针）配合 omitempty 可精准控制字段是否输出，从而支持默认 true、显式 false、以及完全省略三种状态。
在 go 的 json 序列化中，`bool` 类型无法区分“未设置”和“显式设为 false”，导致 api 默认值逻辑失效；使用 `*bool`（布尔指针）配合 `omitempty` 可精准控制字段是否输出，从而支持默认 `true`、显式 `false`、以及完全省略三种状态。
在构建 Go 客户端库对接 RESTful API 时，布尔字段的 JSON 序列化行为常引发逻辑歧义。根本原因在于：Go 中 bool 是值类型，其零值为 false，而 json:",omitempty" 将 false 视为“空值”并忽略——这使得你既无法保留 true 默认值，又无法可靠发送 false。
*解决方案：改用 `bool`（布尔指针）**
指针的零值是 nil，它天然区分三种状态：
- nil → 字段不参与序列化（omitempty 生效），API 使用服务端默认值（如 true）；
- &true → 序列化为 "some_value": true；
- &false → 序列化为 "some_value": false。
type RequestPayload struct {
SomeValue *bool `json:"some_value,omitempty"`
}
完整示例：
package main
import (
"encoding/json"
"fmt"
)
type RequestPayload struct {
SomeValue *bool `json:"some_value,omitempty"`
}
func main() {
// 场景1：未设置（nil）→ 字段被省略
s1, _ := json.Marshal(RequestPayload{})
fmt.Println(string(s1)) // {}
// 场景2：显式设为 true
t := true
s2, _ := json.Marshal(RequestPayload{SomeValue: &t})
fmt.Println(string(s2)) // {"some_value":true}
// 场景3：显式设为 false
f := false
s3, _ := json.Marshal(RequestPayload{SomeValue: &f})
fmt.Println(string(s3)) // {"some_value":false}
}
✅ 优势总结
- 完全符合 REST API 设计惯例：未传字段 = 使用默认值，显式传 false = 覆盖默认值；
- 零侵入式兼容：无需修改服务端逻辑，仅客户端结构体调整；
- 类型安全：编译期检查，避免字符串误写或 magic value。
⚠️ 注意事项
- 使用前务必初始化指针（如 &true 或 &false），避免解引用 nil 导致 panic；
- 若需频繁构造，可封装辅助方法（如 WithSomeValue(v bool) *RequestPayload）提升可读性；
- 服务端反序列化时也应支持 null（对应 *bool 的 nil），确保双向语义一致。
这一模式同样适用于 *int, *string 等需要区分“未设置”与“零值”的场景，是 Go JSON API 开发中的关键实践。
