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:
本文档主要讲述的是使用JSON进行网络数据交换传输;JSON(JavaScript ObjectNotation)是一种轻量级的数据交换格式,易于阅读和编写,同时也易于机器解析和生成,非常适合于服务器与客户端的交互。JSON采用与编程语言无关的文本格式,但是也使用了类C语言的习惯,这些特性使JSON成为理想的数据交换格式。 和 XML 一样,JSON 也是基于纯文本的数据格式。由于 JSON 天生是为 JavaScript 准备的,因此,JSON的数据格式非常简单,您可以用 JSON 传输一个简单的 St
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场景都能应对。注意字段导出性和类型匹配即可避免常见错误。









