GolangJSON解析与序列化详解

学习Golang要努力，但是不要急！今天的这篇文章《Golang JSON解析与序列化教程》将会介绍到等等知识点，如果你想深入学习Golang，可以关注我！我会持续更新相关文章的，希望对大家都能有所帮助！

json.Unmarshal返回nil但字段为零值，是因为未导出字段（小写首字母）或JSON key与struct tag不匹配导致忽略；缺失字段保持零值是设计行为而非bug。

为什么 json.Unmarshal 返回 nil 但结构体字段仍是零值？

常见现象：调用 json.Unmarshal 没报错，但解析后结构体字段全是 0、"" 或 nil。根本原因通常是字段未导出（首字母小写）或 JSON key 与 struct tag 不匹配。

• Go 的 encoding/json 只能访问**导出字段**（首字母大写），小写字段会被忽略
• JSON 字段名默认按字段名（驼峰转小写下划线）匹配，但更可靠的是显式用 json: tag 控制映射
• 如果 JSON 中有字段缺失，对应字段保持 Go 初始化零值，不会报错 —— 这是设计行为，不是 bug

type User struct {
    ID    int    `json:"id"`
    Name  string `json:"name"`
    Email string `json:"email,omitempty"` // 空值不序列化，反序列化时缺失则设为 ""
    age   int    `json:"age"`             // 小写字段，Unmarshal 完全忽略
}

如何安全处理可能缺失或类型不一致的 JSON 字段？

线上 JSON 数据常有字段缺失、空字符串代替 null、数字混用字符串等。硬解到具体类型容易 panic 或静默失败。

• 对不确定字段，先解到 interface{} 或 json.RawMessage，再按需转换
• 用 json.RawMessage 延迟解析嵌套结构，避免重复解码开销
• 检查字段是否存在：用 map[string]interface{} 解一次，再判断 key 是否在 map 中

var raw map[string]interface{}
if err := json.Unmarshal(data, &raw); err != nil {
    return err
}
if _, ok := raw["user_id"]; !ok {
    return fmt.Errorf("missing required field: user_id")
}
// 后续再把 raw["user_id"] 转成 int 或 string

json.Marshal 为什么输出空对象 {} 或乱码？

典型表现：结构体明明有数据，json.Marshal 却返回 {}；或中文变成 Unicode 转义（如 "\u4f60\u597d"）。

• 字段未导出 → 序列化结果不含该字段，所有字段都不导出就得到 {}
• 字段有 json:"-" tag → 显式排除，也会消失
• 中文显示为 \uXXXX：这是标准 JSON 行为；如需可读中文，用 json.MarshalIndent 并确保终端/环境支持 UTF-8
• 时间字段默认序列化为纳秒整数，不是 RFC3339 字符串 —— 需自定义 MarshalJSON 方法

嵌套结构 + 动态 key 怎么写 struct tag？

遇到类似 {"2024-01-01": {"status": "ok"}, "2024-01-02": {"status": "fail"}} 这种以日期为 key 的 JSON，不能靠固定字段名建模。

• 必须用 map[string]YourStruct 类型接收，且 key 类型只能是 string、int 等可比较类型
• struct tag 对 map 本身无效，只作用于 map 的 value 类型字段
• value 结构体仍需正确导出 + tag，否则内部字段无法解析

type DayReport struct {
    Status string `json:"status"`
}
var reports map[string]DayReport
json.Unmarshal(data, &reports) // data 是 { "2024-01-01": {"status":"ok"} }

字段导出、tag 对齐、延迟解析这三件事，漏掉任一环都可能导致“看起来没报错，其实什么都没解析进去”。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。