怎样用Golang处理JSON数据解析encoding/json的基本用法-Golang-PHP中文网

怎样用Golang处理JSON数据解析encoding/json的基本用法

P粉602998670

发布： 2025-08-03 12:25:01

原创

840人浏览过

在go语言中处理json数据最常用的方式是使用encoding/json包。该包支持结构化和非结构化的解析与生成，主要用法包括：1. 结构体与json的互相转换，需定义结构体并使用json标签控制字段名，序列化用json.marshal，反序列化用json.unmarshal且需传入指针；2. 解析未知结构的json时可使用map[string]interface{}进行灵活解析，但需手动做类型断言；3. 嵌套结构可通过定义对应的嵌套结构体来处理，只要结构匹配即可正确映射；4. 其他技巧如忽略字段用json:"-"，空值处理加omitempty，时间类型可自定义格式，性能优化则建议提前定义好结构体和变量以减少内存分配。掌握这些要点能够满足日常开发中的json处理需求。

怎样用Golang处理JSON数据解析encoding/json的基本用法

在Go语言中处理JSON数据，最常用的方式是使用标准库里的

encoding/json

登录后复制

包。这个包提供了结构化和非结构化的JSON解析与生成能力，适合大多数实际场景。

下面我们就来看看几个关键用法，帮助你快速上手。

结构体与JSON的互相转换

这是最常见的需求：把一个结构体转成JSON字符串，或者反过来，从JSON字符串解析到结构体。

立即学习“go语言免费学习笔记（深入）”；

举个例子：

type User struct {
    Name  string `json:"name"`
    Age   int    `json:"age"`
    Email string `json:"email,omitempty"` // omitempty表示如果为空则忽略该字段
}

登录后复制

你可以这样把结构体转为JSON：

user := User{Name: "Alice", Age: 25}
data, _ := json.Marshal(user)
fmt.Println(string(data)) // 输出：{"name":"Alice","age":25}

登录后复制

反过来也一样：

jsonStr := `{"name":"Bob","age":30}`
var user2 User
json.Unmarshal([]byte(jsonStr), &user2)

登录后复制

几点需要注意：

字段名首字母要大写，否则无法被导出（exported）
使用标签（tag）控制JSON字段名
接收数据时一定要传指针（&user）

解析未知结构的JSON（map方式）

有时候你不知道JSON的具体结构，比如接收到第三方API返回的数据，这时候可以用

map[string]interface{}

登录后复制

来解析。

使用JSON进行网络数据交换传输中文WORD版

本文档主要讲述的是使用JSON进行网络数据交换传输；JSON（JavaScript ObjectNotation）是一种轻量级的数据交换格式，易于阅读和编写，同时也易于机器解析和生成，非常适合于服务器与客户端的交互。JSON采用与编程语言无关的文本格式，但是也使用了类C语言的习惯，这些特性使JSON成为理想的数据交换格式。和 XML 一样，JSON 也是基于纯文本的数据格式。由于 JSON 天生是为 JavaScript 准备的，因此，JSON的数据格式非常简单，您可以用 JSON 传输一个简单的 St

查看详情

例如：

jsonStr := `{"name":"Tom","hobbies":["reading","coding"]}`
var data map[string]interface{}
json.Unmarshal([]byte(jsonStr), &data)

fmt.Println(data["name"])         // 输出 Tom
fmt.Println(data["hobbies"])      // 输出 [reading coding]

登录后复制

这种方式灵活但需要手动做类型断言：

hobbies := data["hobbies"].([]interface{})
for _, h := range hobbies {
    fmt.Println(h.(string))
}

登录后复制

适用于结构不固定或嵌套较深的场景。

嵌套结构怎么处理？

遇到嵌套结构，比如结构体里嵌套另一个结构体，也不用担心，只要定义好对应的结构即可。

比如：

type Address struct {
    City  string `json:"city"`
    Zip   string `json:"zip"`
}

type User struct {
    Name    string  `json:"name"`
    Contact Address `json:"contact"`
}

登录后复制

对应的JSON：

{
  "name": "John",
  "contact": {
    "city": "Shanghai",
    "zip": "200000"
  }
}

登录后复制

解析过程是一样的，只要结构对得上，就能正确映射进去。

小技巧和常见问题

字段忽略：加
```
json:"-"
```
登录后复制
可以让字段不参与序列化
空值处理：加上
```
omitempty
```
登录后复制
可避免输出空字段，如
```
"email,omitempty"
```
登录后复制
字段必须存在但允许为空：
```
omitempty
```
登录后复制
会跳过零值，但如果想保留字段，即使为空也要显式写出，就不加这个选项
时间类型处理：
```
time.Time
```
登录后复制
默认格式是RFC3339，如需自定义，可以包装类型并实现
```
MarshalJSON
```
登录后复制
和
```
UnmarshalJSON
```
登录后复制
性能优化：如果频繁处理大量JSON，可以考虑提前定义好结构体和变量，避免重复分配内存