如何在Golang中使用encoding/json处理JSON数据_Golang encoding/json JSON解析方法汇总

Go的encoding/json库通过json.Marshal和Unmarshal实现结构体与JSON互转,配合struct标签可自定义字段名、忽略空值或私有字段;2. 使用map[string]interface{}和类型断言处理动态JSON,注意数字默认解析为float64;3. 对大文件采用json.Decoder/Encoder流式读写以节省内存;4. 关键细节包括omitempty触发条件、string标签用于数值转字符串及RawMessage延迟解析。

在Golang中,encoding/json 是处理JSON数据的标准库,广泛用于Web服务、API开发和配置解析。它提供了将Go结构体与JSON格式相互转换的能力,使用简单且性能良好。下面介绍常用方法和技巧,帮助你高效处理JSON数据。

1. 基本的JSON序列化与反序列化

Go中最常用的两个函数是 json.Marshaljson.Unmarshal

json.Marshal 将Go值转换为JSON字符串:

type User struct {
    Name  string `json:"name"`
    Age   int    `json:"age"`
    Email string `json:"email,omitempty"`
}

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

json.Unmarshal 将JSON数据解析到Go变量:

jsonData := `{"name":"Bob","age":30,"email":"bob@example.com"}`
var user User
json.Unmarshal([]byte(jsonData), &user)
// user.Name == "Bob", user.Age == 30, user.Email == "bob@example.com"

2. 结构体标签(Struct Tags)控制字段映射

通过 json: 标签可以自定义字段名、忽略空值或跳过字段。

  • json:"fieldName":指定JSON中的键名
  • json:"-":忽略该字段不参与序列化/反序列化
  • json:",omitempty":当字段为空值时(如零值、nil、空字符串等),不输出到JSON
  • json:",string":将数值或布尔值以字符串形式编码(适用于int64转string等场景)
type Product struct {
    ID    int64   `json:"id,string"`     // 输出为字符串数字
    Name  string  `json:"product_name"`
    Price float64 `json:"price,omitempty"`
    Secret string `json:"-"`             // 不导出
}

3. 处理未知或动态JSON结构

当无法提前定义结构体时,可使用 map[string]interface{}interface{} 接收数据。

var data map[string]interface{}
json.Unmarshal([]byte(`{"name":"Tom","age":28,"active":true}`), &data)

// 访问字段需类型断言
name := data["name"].(string)
age := int(data["age"].(float64)) // 注意:JSON数字默认解析为float64

也可以使用 json.RawMessage 延迟解析部分JSON内容,提升性能或实现条件解析。

4. 流式读写大JSON文件

对于大型JSON数据流,推荐使用 json.Decoderjson.Encoder,避免一次性加载全部内容。

从文件或HTTP请求中读取JSON流:

file, _ := os.Open("users.json")
defer file.Close()

decoder := json.NewDecoder(file)
for decoder.More() {
    var user User
    if err := decoder.Decode(&user); err == nil {
        // 处理每个user对象
    }
}

写入流式JSON:

encoder := json.NewEncoder(os.Stdout)
encoder.Encode(User{Name: "John", Age: 35})

基本上就这些。熟练掌握 encoding/json 的核心功能后,无论是构建REST API还是解析配置文件,都能得心应手。关键是理解结构体标签的用法、空值处理机制以及如何应对动态结构。不复杂但容易忽略细节,比如 float64 的类型转换和 omitempty 的触发条件。