在go语言中处理json数据最常用的方式是使用encoding/json包。该包支持结构化和非结构化的解析与生成,主要用法包括:1. 结构体与json的互相转换,需定义结构体并使用json标签控制字段名,序列化用json.marshal,反序列化用json.unmarshal且需传入指针;2. 解析未知结构的json时可使用map[string]interface{}进行灵活解析,但需手动做类型断言;3. 嵌套结构可通过定义对应的嵌套结构体来处理,只要结构匹配即可正确映射;4. 其他技巧如忽略字段用json:"-",空值处理加omitempty,时间类型可自定义格式,性能优化则建议提前定义好结构体和变量以减少内存分配。掌握这些要点能够满足日常开发中的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进行网络数据交换传输;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,可以考虑提前定义好结构体和变量,避免重复分配内存
基本上就这些,Golang处理JSON不算复杂,但有些细节容易忽略,比如字段导出、指针传递、嵌套结构等。掌握这几个基本用法,应付日常开发已经绰绰有余了。









