json.Marshal默认只序列化首字母大写的导出字段，小写字段被跳过；json tag控制行为，如"-"忽略、",omitempty"零值省略、",string"强制转字符串；拼写错误（如omitemtpy）会导致tag失效。
json.Marshal 会忽略 struct 字段？检查导出规则和 tag
Go 的 json.Marshal 默认只序列化首字母大写的导出字段，小写开头的字段直接被跳过，不是 bug，是设计如此。如果你看到输出里字段“消失”了，先确认字段名是否以大写字母开头。
另外，json tag 控制行为，但容易写错：
-
json:"-"完全忽略该字段（注意引号后不能有空格） -
json:"name,omitempty"表示值为零值（0、""、nil 等）时不输出该字段 -
json:"name,string"强制将数值类型（如 int）转成字符串序列化（常用于 API 兼容）
常见错误：把 json:"name,omitemtpy" 拼错了，少了个 y，结果 tag 不生效，字段照常输出——Go 不报错，但行为不符合预期。
反序列化时 struct 字段收不到值？注意类型匹配和零值覆盖
json.Unmarshal 要求目标字段可寻址、可赋值，且类型兼容。最常踩的坑是：用 int 接收 JSON 中的数字，但实际传的是 float64（JSON 规范里所有数字都是浮点），导致反序列化失败或 panic。
立即学习“go语言免费学习笔记（深入）”；
典型表现：json: cannot unmarshal number into Go struct field X.Y of type int
- 稳妥做法：统一用
float64接数字，再按需转换；或用自定义UnmarshalJSON方法处理 - 如果字段已初始化为非零值（比如切片是
[]string{"a"}），而 JSON 中没提供该字段，默认不会清空它——omitempty只影响序列化，不影响反序列化逻辑 - 嵌套 struct 字段必须导出，否则即使 JSON 有对应 key，也不会赋值
处理未知结构或动态字段？别硬套 struct，用 map[string]interface{}
当 JSON 结构不固定（比如返回字段随配置变化、第三方 API 响应不一致），强行定义 struct 会导致维护成本高、易 panic。这时候该上 map[string]interface{}。
但要注意：
- 嵌套对象会变成
map[string]interface{}，数组变成[]interface{}，需要手动类型断言，比如v["data"].([]interface{}) - JSON 数字一律解析为
float64，哪怕原始是123，断言成int会失败，得先转int(v.(float64)) - 性能比 struct 差，因为要运行时做类型推导和反射；高频场景建议只在入口层用，解析后尽快转成明确 struct
中文乱码或 HTML 转义？控制 Encoder 的 EscapeHTML 行为
默认 json.Marshal 会对 、<code>>、& 做 HTML 转义（变成 \u003c），这是为防 XSS 预设的安全策略。但如果你输出的是纯 API JSON，前端不需要这层转义，反而增加体积、干扰调试。
- 改用
json.NewEncoder+SetEscapeHTML(false)：
enc := json.NewEncoder(w) enc.SetEscapeHTML(false) enc.Encode(data)
- 注意：这个设置只对
Encode()生效，json.Marshal不受此影响 - 如果服务同时输出 HTML 和 JSON，别全局关掉，只在 JSON 响应路径中关闭
还有个隐藏问题：Go 默认用 UTF-8，只要源数据是合法 UTF-8 字符串，就不会出现“中文变问号”，所谓乱码，八成是前端没声明 Content-Type: application/json; charset=utf-8 或响应体被中间件二次编码了。
