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

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

P粉602998670

发布： 2025-12-21 15:17:02

原创

463人浏览过

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

如何使用golang处理json数据_golang encoding json解析与序列化示例

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

定义结构体并映射 JSON 字段

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

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

示例：

Upscale

AI图片放大工具

查看详情

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><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">go语言免费学习笔记（深入）</a>”；</p>
<ul>
  <li>如果 JSON 字段在结构体中不存在，会被静默忽略；</li>
  <li>类型不匹配会返回错误（如 JSON 数字写入 string 字段）；</li>
  <li>支持部分解析：结构体只定义需要的字段，其余自动丢弃。</li>
</ul>
<p>示例：</p>
<font color="#888"><pre class="brush:php;toolbar:false;">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 场景。

以上就是如何使用Golang处理JSON数据_Golang encoding JSON解析与序列化示例的详细内容，更多请关注php中文网其它相关文章！