首页 > Golang > Go教程

GolangJSON解析与序列化详解

时间：2026-01-05 10:36:38 394浏览收藏

你在学习Golang相关的知识吗？本文《Golang JSON解析与序列化教程》，主要介绍的内容就涉及到，如果你想提升自己的开发能力，就不要错过这篇文章，大家要知道编程理论基础和实战操作都是不可或缺的哦！

Go语言json包通过结构体标签、指针与零值处理、错误处理及RawMessage实现高效JSON解析与序列化。支持字段映射、omitempty忽略零值、嵌套结构、动态解析等核心功能。

如何使用Golang处理JSON数据_Golang encoding JSON解析与序列化示例

Go 语言内置的 encoding/json 包提供了简洁、高效、安全的 JSON 解析与序列化能力，无需第三方依赖。核心在于理解结构体标签（struct tags）、指针与零值行为、以及错误处理习惯。

定义结构体并映射 JSON 字段

用结构体表示 JSON 数据结构是最常见方式。通过 json: 标签控制字段名映射、是否忽略、是否必须存在等行为：

字段名映射：默认按首字母大写的导出字段名匹配，可用 json:"name" 显式指定；
忽略字段：用 json:"-" 完全跳过，或 json:",omitempty" 在值为零值时省略输出；
嵌套与数组：结构体字段可为其他结构体或切片，自动递归处理。

示例：

type User struct {<br>  ID    int    `json:"id"`<br>  Name  string `json:"name"`<br>  Email  string `json:"email,omitempty"` // 空字符串时不输出<br>  Tags  []string `json:"tags"`<br>  Meta  map[string]interface{} `json:"meta"`<br>}</font>

<h3>将 JSON 字符串解析为 Go 值（Unmarshal）</h3>
<p>使用 <code>json.Unmarshal([]byte, &v)</code> 将字节流反序列化到变量。注意传入地址（<code>&v</code>），且目标必须是可寻址的变量。</p>
<ul><li>如果 JSON 字段在结构体中不存在，会被静默忽略；</li>
  <li>类型不匹配会返回错误（如 JSON 数字写入 string 字段）；</li>
  <li>支持部分解析：结构体只定义需要的字段，其余自动丢弃。</li>
</ul><p>示例：</p>
<font color="#888"><pre>data := `{"id":123,"name":"Alice","tags":["dev","go"]}`<br>var u User<br>err := json.Unmarshal([]byte(data), &u)<br>if err != nil {<br>  log.Fatal(err)<br>}<br>// u.ID == 123, u.Name == "Alice", u.Tags == []string{"dev","go"}

将 Go 值序列化为 JSON 字符串（Marshal）

用 json.Marshal(v) 把 Go 变量转成 JSON 字节切片。输出无空格、紧凑格式；若需缩进美化，用 json.MarshalIndent(v, "", " ")。

导出字段（首字母大写）才会被序列化；
omitempty 标签对零值（0、""、nil、false 等）生效；
时间、自定义类型需实现 MarshalJSON() 方法才能正确转换。

示例：

u := User{ID: 456, Name: "Bob", Tags: []string{"test"}}<br>b, _ := json.Marshal(u)<br>// b == {"id":456,"name":"Bob","tags":["test"]}

处理未知或动态 JSON（map[string]interface{} 和 json.RawMessage）

当 JSON 结构不确定或部分嵌套内容需延迟解析时，可用通用类型：

map[string]interface{}：适合快速读取任意对象，但需手动类型断言；
json.RawMessage：延迟解析某字段，避免重复解码，特别适合嵌套 JSON 字符串；
结合 interface{} + 类型判断可实现灵活路由逻辑（如不同消息类型共用一个字段）。

示例（延迟解析）：

type Event struct {<br>  Type string        `json:"type"`<br>  Data json.RawMessage `json:"data"`<br>}<br><br>var e Event<br>json.Unmarshal(b, &e)<br>if e.Type == "user_created" {<br>  var u User<br>  json.Unmarshal(e.Data, &u)<br>  // 处理用户数据<br>}

基本上就这些。熟练掌握结构体标签、零值处理和 RawMessage 的组合，就能应对绝大多数 JSON 场景。

本篇关于《GolangJSON解析与序列化详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！

前往漫画官网入口并下载 ➜