Go结构体序列化与反序列化详解

小伙伴们有没有觉得学习Golang很有意思？有意思就对了！今天就给大家带来《Go 中结构体序列化与反序列化全解析》，以下内容将会涉及到，若是在学习中对其中部分知识点有疑问，或许看了本文就能帮到你！

Go 的 json 包默认忽略非导出（小写首字母）字段，但通过自定义 MarshalJSON 和 UnmarshalJSON 方法，可显式控制所有字段的 JSON 编解码行为，无需暴露内部字段。

在 Go 中，encoding/json 包仅能访问结构体的导出字段（即首字母大写的字段），因此像 fieldA string 这样的非导出字段默认不会参与 JSON 序列化。若需同时处理导出与非导出字段，不能依赖嵌入原结构体的方式递归调用 json.Marshal（如 *Test 嵌入会导致无限递归），而应采用「中间结构体（DTO）」策略：定义一个纯导出字段的辅助结构体，作为 JSON 编解码的桥梁。

以下是一个清晰、安全且可维护的实现方案：

type Test struct {
    fieldA string // 非导出，仅内部使用
    FieldB int    // 导出，可被 json 默认处理，但此处统一由自定义逻辑控制
    FieldC string // 导出
}

// TestJSON 是专用于 JSON 传输的导出结构体，字段全部大写且带 json 标签
type TestJSON struct {
    FieldA string `json:"fieldA"`
    FieldB int    `json:"fieldB"`
    FieldC string `json:"fieldC"`
}

func (t *Test) MarshalJSON() ([]byte, error) {
    return json.Marshal(TestJSON{
        FieldA: t.fieldA,
        FieldB: t.FieldB,
        FieldC: t.FieldC,
    })
}

func (t *Test) UnmarshalJSON(b []byte) error {
    var temp TestJSON
    if err := json.Unmarshal(b, &temp); err != nil {
        return err
    }
    // 显式赋值回原结构体，保持封装性
    t.fieldA = temp.FieldA
    t.FieldB = temp.FieldB
    t.FieldC = temp.FieldC
    return nil
}

✅ 优势说明：

• 无递归风险：不嵌入 *Test，彻底避免 MarshalJSON 自调用导致的栈溢出；
• 类型安全：TestJSON 是独立结构体，字段名与标签明确，修改 Test 字段时只需同步更新 TestJSON 和编解码逻辑，IDE 可精准提示；
• 封装性完好：fieldA 仍为非导出字段，外部包无法直接访问，仅通过 JSON 接口可控暴露；
• 扩展友好：新增字段时，只需在 TestJSON 中添加对应字段及 MarshalJSON/UnmarshalJSON 中的赋值语句，逻辑集中、不易遗漏。

⚠️ 注意事项：

• UnmarshalJSON 中必须使用 &temp（取地址）传递指针给 json.Unmarshal，否则解码无效；
• 若 Test 包含嵌套结构体或需要深度复制的字段（如切片、map），应在 UnmarshalJSON 中进行深拷贝，避免外部修改影响内部状态；
• 不建议为简单场景强行保留非导出字段——若 fieldA 本质是公共数据，直接导出（FieldA）并利用 json 标签更简洁；本方案适用于确有封装需求（如字段需校验、惰性加载或权限控制）的场景。

总之，中间结构体法是 Go 中平衡封装性与序列化灵活性的标准实践，比手动拼接 JSON 字符串或反射更安全、比全字段导出更严谨。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~