omitempty仅忽略字段的零值（如""、0、false、nil），非nil指针即使指向零值也不会被忽略；标签格式必须为json:"key,omitempty"，且字段需导出。
Go 的 json.Marshal 默认不会忽略空字段，必须显式用 omitempty 标签才能跳过零值字段——但这个“零值”和你想的可能不一样。
为什么加了 omitempty 还没被忽略？
常见现象：json.Marshal 输出里依然有 "name":"" 或 "count":0，明明结构体字段加了 json:",omitempty"。
-
omitempty只判断字段是否为该类型的**零值**：字符串是""、整数是0、布尔是false、切片/映射/指针是nil - 如果字段是空字符串
""、整数0、布尔false，它们本身就是零值，omitempty会生效；但如果字段是"0"（字符串）、1（非零）、或*int{0}（非 nil 指针），omitempty就不触发 - 特别注意：指针类型哪怕指向零值（比如
*int{0}），只要不是nil，就不会被忽略
omitempty 在 struct 字段上的正确写法
标签必须写在 struct 字段的 json tag 里，且逗号不能漏，顺序无关紧要，但 omitempty 必须是独立 token。
- ✅ 正确：
Name string `json:"name,omitempty"`、Age *int `json:"age,omitempty"` - ❌ 错误：
Name string `json:"name, omitempty"`（多了空格）、Name string `json:"name,omitempty,"`（结尾多逗号） - ⚠️ 注意：如果字段名首字母小写（未导出），无论加什么 tag 都不会出现在 JSON 中——
omitempty前提是字段可导出
想忽略空字符串但保留 0 怎么办？
标准 json 包做不到“按需定义零值”，只能靠类型封装或自定义 MarshalJSON 方法。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 最常用解法：用指针类型，如
*string，这样nil表示“未设置”，空字符串*s = new(string)仍可区分 - 更灵活但稍重：为字段类型实现
json.Marshaler接口，例如自定义一个NonEmptyString类型，在MarshalJSON里判断len(s) == 0就返回nil（即跳过） - 别踩坑：别试图用
string+omitempty同时满足“空字符串不出现”和“0 数字出现”——它俩零值冲突，无法兼顾
嵌套 struct 和 map 的 omitempty 行为
嵌套结构体本身是否被忽略，取决于其所有字段是否都为零值（递归判断）；map 则只看是否为 nil，不看长度。
- struct 示例：
Addr Address `json:"addr,omitempty"`，只有当Address{}所有字段都是零值时，整个addr字段才消失 - map 示例：
Data map[string]string `json:"data,omitempty"`，nil→ 不出现；map[string]string{}（空 map）→ 仍输出"data":{} - 切片同理：
Items []string `json:"items,omitempty"`，nil→ 不出现；[]string{}→ 输出"items":[]
真正麻烦的是混合场景：比如 API 返回既要兼容老前端（要求字段存在），又要精简传输（新客户端希望省掉空字段）。这时候别硬靠 omitempty，直接拆两个 struct，或用 map 动态构造更可控。
