Go 的 json 包中，omitempty 标签会将零值（如 int 类型的 0、string 的 ""、bool 的 false）视为“空”而省略字段；若需保留 0 值，应改用指针类型以区分“未设置”与“显式设为 0”。
go 的 `json` 包中，`omitempty` 标签会将零值（如 `int` 类型的 `0`、`string` 的 `""`、`bool` 的 `false`）视为“空”而省略字段；若需保留 `0` 值，应改用指针类型以区分“未设置”与“显式设为 0”。
在 Go 的 JSON 编解码中，omitempty 是一个常用但易被误解的结构体标签。它的本意是“当字段值为其类型的零值时，序列化时跳过该字段”，而非“仅当字段未被赋值时才忽略”。因此，对于 int 类型，0 就是其零值，json.Marshal 会直接剔除 "integer": 0 字段——这正是你观察到的行为：无论原始 JSON 中 integer 是 0 还是解码后手动赋值为 0，只要结构体字段是值类型且启用了 omitempty，它就会消失。
✅ 正确解决方案：使用指针类型
通过将字段定义为指针（如 *int、*string），可实现语义分离：
- nil 表示 JSON 中该字段不存在（即“未提供”）；
- &v（例如 &zero）表示该字段显式存在且值为 v（包括 0）。
type Test struct {
String *string `json:"string,omitempty"`
Integer *int `json:"integer,omitempty"`
}
// 使用示例
q := []byte(`{"string":"this is a string", "integer": 0}`)
var qq Test
if err := json.Unmarshal(q, &qq); err != nil {
panic(err)
}
// 此时 qq.Integer 指向一个值为 0 的 int
queryStr, err := json.Marshal(qq)
if err != nil {
panic(err)
}
fmt.Println(string(queryStr))
// 输出: {"string":"this is a string","integer":0}
⚠️ 注意事项：
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 解析后需检查指针是否为 nil，避免 panic：if qq.Integer != nil { fmt.Println(*qq.Integer) }
- 若需默认值逻辑（如“字段缺失时设为 5”），应在业务层显式判断，而非依赖 omitempty
- 不推荐为同一用途维护两套结构体（输入/输出），除非字段语义或校验规则差异极大；指针方案已兼顾兼容性与语义清晰性
- 其他零值类型同理：*bool 可区分 false 与未设置，*float64 可保留 0.0
总结：omitempty 的设计初衷是优化传输体积，而非表达业务上的“可选默认值”。当 0 具有明确业务含义（如“关闭状态”“无数量”），就必须打破值类型与缺失状态的耦合——指针是最简洁、标准且符合 Go 惯用法的解决路径。
