json:"-" 不生效的根本原因是字段未导出（首字母小写），因 json.Marshal 仅处理导出字段，未导出字段本就不会被扫描，标签自然无效；真正生效场景是作用于导出字段以强制排除。
为什么 struct tag 里的 json:"-" 有时不生效？
因为 Go 的 JSON 序列化只处理导出字段（首字母大写），json:"-" 对未导出字段根本不起作用——它压根不会被 json.Marshal 扫描到。真正要忽略的，是那些本该导出、但你临时不想序列化的字段。
常见错误：给一个 privateField string 加 json:"-"，结果发现它本来就不会出现在 JSON 里，误以为 tag 生效了；或者把 json:"name,omitempty" 写成 json:"name, omitempty"（多了一个空格），导致 omitempty 被忽略。
- 必须确保字段是导出的（如
Name string），否则 tag 无意义 -
json:"-"是硬性排除，无论值是否为空都跳过 -
omitempty只对零值生效：""、0、false、nil切片/映射/指针等 - 嵌套结构体中，如果外层字段为 nil，即使内层有
omitempty，整个字段也不会出现
如何动态控制哪些字段参与 JSON 序列化？
Go 标准库不支持运行时开关字段，但可以用组合方式模拟：定义多个 struct，或用 map[string]interface{} + 条件赋值。前者类型安全但冗余，后者灵活但失去编译检查。
更实用的做法是封装一个带选项的序列化函数，比如接收一个 excludedFields []string，再通过反射过滤字段。但要注意性能开销和反射的局限性（无法处理私有字段、接口字段可能 panic）。
立即学习“go语言免费学习笔记（深入）”；
- 简单场景直接用
map[string]interface{}构建输出：只塞你想暴露的键值对 - 需要类型保障时，定义两个 struct：
UserPublic和UserInternal，用struct{}匿名嵌入共用字段 - 别在生产高频路径上用反射做字段过滤；100 次以内调用可接受，高并发服务建议预生成 map 或用代码生成工具
-
json.Marshal不会报错字段不存在，但若反射读取失败（如字段不可寻址），会 panic
json.RawMessage 怎么用来延迟解析动态字段？
当 API 返回结构不确定的字段（比如 "data": {...} 中内容格式随 type 字段变化），硬编码 struct 会频繁修改。这时把 data 声明为 json.RawMessage，就能先跳过解析，等后续根据上下文再解。
注意它本质是 []byte，所以不能直接当 map 或 struct 用；且一旦被 json.Unmarshal 赋值，就只是原始字节，没做任何验证。
- 声明字段如：
Data json.RawMessage `json:"data"` - 后续按需解析：
json.Unmarshal(user.Data, &SpecificType{}) - 如果想保留原始 JSON 字符串用于日志或转发，
string(user.Data)即可，无需重新 marshal - 不要对
json.RawMessage字段用omitempty——它永远不会为 nil，哪怕原始 JSON 是null，也会存成空字节数组
嵌套结构中 omitempty 为何有时“失效”？
比如有个 Profile *UserProfile 字段，加了 omitempty，但即使 Profile == nil，JSON 里还是出现了 "profile": null。这是因为指针本身非 nil（比如被初始化为 &UserProfile{}），或者 struct 字段虽为零值但不是整体为零值。
关键点在于：omitempty 判断的是字段值是否为「零值」，而指针的零值是 nil，但 *UserProfile 类型的字段若指向一个空 struct 实例，就不算零值。
- 确认指针是否真为
nil：打印fmt.Printf("%v", user.Profile == nil) - 避免意外初始化：
Profile: &UserProfile{}→ 改为Profile: nil - 如果 struct 内部字段全为零值，但 struct 本身不是「零值」（Go 中 struct 零值是所有字段为零），
omitempty仍会保留该字段 - 想彻底隐藏，要么用
json:"-"，要么改用map[string]interface{}动态构造
json.RawMessage 在反序列化后无法再被其他 JSON 操作函数（如 json.MarshalIndent）自动美化——它原样透传字节，缩进、换行、转义全靠你手动控制。 
