在 Go 的 JSON 序列化中，使用 bool 类型配合 omitempty 无法区分“未设置”和“显式设为 false”，导致 API 默认行为失效；解决方案是改用 *bool 指针类型，使零值（nil）表示省略，而 &true/&false 均能被准确编码。
在 go 的 json 序列化中，使用 `bool` 类型配合 `omitempty` 无法区分“未设置”和“显式设为 false”，导致 api 默认行为失效；解决方案是改用 `*bool` 指针类型，使零值（nil）表示省略，而 `&true`/`&false` 均能被准确编码。
在构建面向 RESTful API 的 Go 客户端库时，布尔字段的语义表达尤为关键。例如，某字段 some_value 在服务端默认为 true，客户端需支持三种状态：
- 未提供该字段 → 服务端使用默认值 true；
- 显式设置为 true → 字段出现在请求体中，值为 true；
- 显式设置为 false → 字段出现在请求体中，值为 false。
原生 bool 类型无法满足这一需求：
- 若使用 `json:"some_value,omitempty"`，则 false 被视为“空值”而被忽略（因 bool 的零值是 false），导致 false 无法传递；
- 若去掉 omitempty，则零值 false 总是被序列化，造成“未设置”误传为 false。
✅ 正确解法是使用 *`bool`（布尔指针）**：
wechat-article-extraction-mp-weixin-qq-com news-webpage-cleaning blog-post-parsing metadata-extraction-title-author-date multiple-output-formats-markdown-json-plain-text batch-processing-support
下载
基于三引擎设计，从微信文章、新闻和博客网页提取干净内容，支持标题作者日期元数据，多格式和批量处理。
- nil 指针 → omitempty 触发，字段被省略；
- &true 或 &false → 非 nil，字段被序列化，值准确反映业务意图。
以下是可直接运行的示例代码：
package main
import (
"encoding/json"
"fmt"
)
type Request struct {
SomeValue *bool `json:"some_value,omitempty"`
}
func main() {
// 场景1：未设置（nil）→ 字段省略
s1, _ := json.Marshal(Request{SomeValue: nil})
// 场景2：显式 true
t := true
s2, _ := json.Marshal(Request{SomeValue: &t})
// 场景3：显式 false
f := false
s3, _ := json.Marshal(Request{SomeValue: &f})
fmt.Println(string(s1)) // {}
fmt.Println(string(s2)) // {"some_value":true}
fmt.Println(string(s3)) // {"some_value":false}
}
? 注意事项：
- 使用指针会略微增加内存开销与解引用成本，但在绝大多数 API 客户端场景中可忽略；
- 反序列化时，*bool 同样适用：JSON 中缺失字段 → nil；true/false → 对应非 nil 指针；
- 若需频繁构造，可封装辅助方法（如 BoolPtr(b bool) *bool）提升可读性；
- 避免对 nil *bool 进行解引用（panic），访问前务必判空。
综上，*bool 是 Go 中表达“三态布尔”（未设置 / 显式真 / 显式假）的标准、安全且符合 JSON 语义的设计模式，也是官方推荐实践（见 Go JSON 文档 关于 omitempty 与指针的说明）。
