json.Marshal默认不处理私有字段、不支持循环引用、nil slice/map输出null、time.Time转RFC3339字符串——均为设计选择；字段需首字母大写才导出，tag格式须正确，nil指针需omitempty防panic。
直接说结论： json.Marshal 默认不处理私有字段、不支持循环引用、对 nil slice/map 输出空结构，且时间类型会转成 RFC 3339 字符串——这些不是 bug，是设计选择，但恰恰是日常踩坑最多的地方。
为什么 struct 字段没被序列化？
Go 的 json.Marshal 只导出首字母大写的字段（即“可导出字段”），小写开头的字段（哪怕加了 json: tag）会被静默忽略。
- 检查字段名是否首字母大写：比如
type User { name string }中的name不会输出，必须写成Name string - tag 写法要正确：
`json:"name,omitempty"`有效，但`json:name`或`json:"name,"`会失效 - 嵌套 struct 也要逐层检查导出性——哪怕外层导出，内层字段不导出照样丢
如何控制 nil slice 或 map 的输出？
默认情况下，nil slice 和 nil map 都会被序列化成 null，而不是 [] 或 {}。这在 API 前后端约定中常引发歧义。
- 想让
nil []string输出[]：用omitempty不够，得初始化为空切片：Roles: []string{} - 想统一把
nil当空值处理：可以封装一个辅助函数，或用自定义类型实现json.Marshaler接口 - 注意
omitempty对nil指针也生效，但对nilinterface{} 无效（它会输出null）
time.Time 序列化出来是字符串，怎么改格式？
json.Marshal 对 time.Time 的默认行为是调用 Time.Format(time.RFC3339)，输出带时区的 ISO 时间字符串，比如 "2024-05-20T14:30:00+08:00"。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 如果需要自定义格式（如去掉时区、用秒级精度），必须实现
json.Marshaler接口 - 常见错误：试图用
json:"time,format=2006-01-02"—— 这个 tag 是encoding/json完全不识别的，纯属无效 - 性能提示：每次序列化都调用
Format有开销，高频场景建议预计算或缓存格式化结果
遇到 invalid memory address 或 panic 怎么办？
典型错误信息：panic: runtime error: invalid memory address or nil pointer dereference，往往发生在 struct 字段是未初始化的指针类型，又没加 omitempty。
- 比如
CreatedAt *time.Time字段为nil，且没加omitempty，json.Marshal会尝试解引用导致 panic - 解决方法：加
omitempty（推荐），或确保指针非 nil（如用&time.Now()初始化），或改用值类型（time.Time） - 更隐蔽的情况：字段类型实现了
json.Marshaler，但其MarshalJSON方法内部 panic 了——这时要查自定义序列化逻辑
最常被忽略的一点：json.Marshal 不做深层校验，它不会告诉你某个字段类型根本不支持 JSON（比如 func()、chan、未导出的 map key 类型），而是在运行时 panic 或静默跳过。上线前务必用真实数据跑一遍序列化路径。
