Go语言通过encoding/json包实现JSON处理,使用Marshal和Unmarshal进行结构体与JSON的相互转换;结构体字段需首字母大写才能导出,通过json标签定义键名、omitempty控制空值忽略、-忽略序列化;支持格式化输出与动态解析到map或interface{},适用于固定及未知结构场景。

在Go语言开发中,处理JSON数据是常见需求,encoding/json包提供了完整的解析与生成能力。它通过Marshal和Unmarshal函数实现结构体与JSON之间的转换,使用简单且性能良好。
结构体与JSON的映射
Go中通常使用结构体来表示JSON数据格式。字段需以大写字母开头才能被encoding/json包访问。
通过结构体标签(struct tag)可自定义JSON键名、控制输出行为:
type User struct {
Name string `json:"name"`
Age int `json:"age"`
Email string `json:"email,omitempty"`
Password string `json:"-"`
}
说明:
立即学习“go语言免费学习笔记(深入)”;
- json:"name":将Name字段对应JSON中的"name"
- omitempty:当Age为0或Email为空字符串时,该字段不会出现在生成的JSON中
- -:Password字段不会参与序列化与反序列化
将结构体编码为JSON(序列化)
使用json.Marshal()将Go值转换为JSON字节流。
user := User{Name: "Alice", Age: 25, Email: "alice@example.com"}
data, err := json.Marshal(user)
if err != nil {
log.Fatal(err)
}
fmt.Println(string(data))
// 输出:{"name":"Alice","age":25,"email":"alice@example.com"}
如需格式化输出,使用json.MarshalIndent:
data, _ := json.MarshalIndent(user, "", " ") fmt.Println(string(data))
从JSON解码为结构体(反序列化)
使用json.Unmarshal()将JSON数据解析到结构体或map中。
jsonStr := `{"name":"Bob","age":30,"email":"bob@example.com"}`
var user User
err := json.Unmarshal([]byte(jsonStr), &user)
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", user)
也可以解析到map:
var data map[string]interface{}
json.Unmarshal([]byte(jsonStr), &data)
fmt.Println(data["name"])
处理动态或未知结构的JSON
当JSON结构不确定时,可用map[string]interface{}或interface{}接收。
遍历嵌套结构时注意类型断言:
var raw interface{}
json.Unmarshal([]byte(jsonStr), &raw)
if m, ok := raw.(map[string]interface{}); ok {
for k, v := range m {
fmt.Printf("%s: %v (%T)\n", k, v, v)
}
}
深层嵌套数组对象也按类似方式处理,需逐层断言类型。
基本上就这些。掌握结构体标签、序列化与反序列化方法后,大部分JSON场景都能应对。注意字段导出性和类型匹配即可避免常见错误。










