omitempty 不生效的首要原因是字段未导出（首字母小写），其次需确认值为真实零值且标签语法正确；导出字段如 name string json:"name,omitempty" 才能触发忽略空值逻辑。
Go struct 字段加 omitempty 不生效？先看字段是否可导出
Go 的 json.Marshal 只能序列化**首字母大写的导出字段**。omitempty 是个标签，不是魔法——如果字段本身不可导出（比如 name string），它压根不会出现在 JSON 里，自然也谈不上“忽略空值”。
- 错误写法：
type User struct { name string `json:"name,omitempty"` }→ 序列化后是{}，连 key 都没有 - 正确写法：
type User struct { Name string `json:`name,omitempty` }→Name导出，omitempty才有机会起作用 - 注意：
omitempty对零值生效，但“零值”取决于类型：空字符串""、0、false、nil指针/切片/map 等
omitempty 为什么没删掉空字符串或 0？检查字段类型和零值
常见误解是“空字符串就该被忽略”，但前提是字段值**确实是零值**。比如指针、自定义类型、嵌套结构体，零值判断可能不符合直觉。
-
*string类型：只有指针为nil才触发omitempty；如果指针非 nil 但指向""，字段仍会输出"field": "" - 自定义类型（如
type Email string）：即使底层是string，它的零值仍是""，omitempty有效；但若实现MarshalJSON方法，行为由该方法控制 - 结构体字段：若字段是结构体，且其所有导出字段均为零值，
omitempty仍会保留该字段（除非结构体本身是nil指针）
用 json.Marshal 还是 json.NewEncoder？影响不大，但别混用调试方式
两者都尊重 omitempty 标签，区别在于使用场景和错误处理粒度。
-
json.Marshal返回[]byte和error，适合小数据、需要中间处理（如日志、拼接）的场景 -
json.NewEncoder(w io.Writer)直接写入流，内存更省，适合 HTTP 响应、大文件写入 - 容易踩的坑：用
fmt.Printf("%v", data)查看 struct 值，误以为 “空” 就等于 JSON 里会被忽略——实际得看json.Marshal输出结果 - 调试建议：直接打印
json.Marshal(data)结果，或用在线工具验证结构体定义
想彻底跳过某个字段？- 标签比 omitempty 更坚决
当字段**永远不该出现在 JSON 中**（比如密码、内部状态），不要依赖 omitempty，它只在零值时生效，而你可能传了非零值但仍不想暴露。
- 用
json:"-"：字段完全被忽略，无论值是什么，也不报错 - 对比：
json:"field,omitempty"在field: "xxx"时一定出现；json:"-"下，哪怕field: "xxx"也消失 - 注意：
json:"-"和json:"field,-"是不同语法；后者等价于json:"field"（逗号后内容被忽略），正确写法只有json:"-"
omitempty 就只是个摆设。实际写的时候，最好边改边跑 json.Marshal 看输出，别靠猜。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
