go json序列化字段不出现，因字段未导出或json标签拼写错误；反射读structtag需用lookup防panic；omitempty仅对零值生效；跨包时需确保类型同源且正确导入。
JSON序列化时字段不出现？检查json标签拼写和导出规则
Go 的 json.Marshal 默认只序列化首字母大写的导出字段，小写字段哪怕加了 json 标签也直接忽略。常见错误是写成 Json:（首字母大写）或 json: 后跟空格、中文冒号，导致解析失败——标签根本没生效。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
json标签必须全小写，且紧贴冒号，如json:"name"，不是Json:"name"或json: "name" - 字段名必须导出（首字母大写），否则
json标签再正确也没用 - 想排除某个导出字段，用
json:"-"；想保留但用不同键名，用json:"user_name" - 注意结构体嵌套时，内层字段也要满足导出 + 正确标签，否则整个嵌套对象可能为空对象
{}
反射读取结构体标签时 panic？别直接用 reflect.StructTag.Get
调用 tag.Get("json") 时如果标签不存在，它不会返回空字符串，而是 panic：「panic: reflect: StructTag.Get: bad syntax for struct tag」。这不是 bug，是 Go 的设计选择——它要求你先确保标签格式合法。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 永远先用
tag.Lookup("json")，它返回value, ok二元组，安全 - 拿到 value 后别直接当字符串切分，用
strings.SplitN(value, ",", 2)拆键值和选项，避免误判omitempty等修饰符 - 若需解析多个选项（如
json:"id,omitempty,string"），建议用structtag这类第三方库，标准库不提供健壮解析
StructTag 中的 omitempty 不起作用？确认字段值是否为「零值」
omitempty 只在字段值等于其类型的零值时才跳过该字段。但「零值」容易被误解：比如 *string 类型的零值是 nil，不是空字符串；time.Time 的零值是 0001-01-01T00:00:00Z，不是 nil（它不能为 nil）；map[string]int 的零值是 nil，空 map {} 反而会被序列化。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 指针类型字段想用
omitempty，必须让指针本身为nil，而不是指向一个零值 - 自定义类型（如
type UserID int）要小心：它的零值仍是0，但如果你希望0表示“未设置”，就得配合指针或额外字段 - 测试时打印
fmt.Printf("%#v", v)看实际值，比肉眼判断更可靠
跨包使用结构体时标签丢失？别忘了 go:build 或构建约束干扰
极少见但真实存在的坑：某些构建约束（如 //go:build ignore）或 vendor 机制异常，会导致反射读不到结构体定义，进而 reflect.TypeOf(T{}).Elem().Field(0).Tag 返回空字符串。更常见的是，你在 A 包定义结构体，在 B 包用反射读它的标签，但 B 包没正确 import A 包，或用了别名导入，导致反射看到的是另一个类型副本。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确认反射操作的对象类型和结构体定义在同一个包，或至少是同一份源码编译而来（非重复 vendoring）
- 用
fmt.Printf("%s", reflect.TypeOf(T{}).PkgPath())检查包路径是否一致 - 避免在
init()函数中过早反射读取未初始化完成的结构体标签
结构体标签看着简单，但它是编译期静态信息 + 运行时反射的交汇点，任何一端出偏差都会静默失效。最麻烦的不是报错，而是“看起来正常却漏数据”——所以关键字段一定要加单元测试，用 json.Marshal 和 reflect 双路验证。
