Go语言json序列化反序列化教程

本文深入剖析了Go语言中JSON序列化与反序列化的关键细节与常见陷阱：从导出字段规则、json tag的正确写法（如omitempty、string、-）及拼写错误的隐蔽影响，到反序列化时的类型兼容性问题（尤其是float64与整型的转换）、零值处理逻辑；同时指出动态JSON场景下map[string]interface{}的适用性与类型断言要点，并揭示中文显示异常的真实原因——往往并非编码问题，而是HTML转义或HTTP头缺失所致。内容兼具原理深度与实战警示，帮你避开90%的JSON“灵异bug”。

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。

典型表现：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 会对 、>、& 做 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 或响应体被中间件二次编码了。

理论要掌握，实操不能落！以上关于《Go语言json序列化反序列化教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！