在golang中处理json的核心在于掌握结构体标签、序列化与反序列化方法及嵌套结构处理。1. 使用结构体字段标签如json:"name"可自定义json键名,支持omitempty和-等选项控制输出行为;2. 通过json.marshal()将结构体转为json字符串,结合omitempty可省略空字段,使用json.marshalindent()可输出美观格式;3. 利用json.unmarshal()将json解析为结构体,需传入指针且字段名匹配即可,支持动态解析到map[string]interface{};4. 嵌套结构如包含地址信息的用户结构同样支持序列化与反序列化,数组、切片、指针等复杂类型也能被标准库妥善处理。这些技巧构成了go语言中高效处理json数据的基础。

在Golang中处理JSON是非常常见的需求,特别是在构建Web服务时。Go语言的标准库encoding/json提供了完整的功能来完成结构体与JSON之间的序列化和反序列化操作。这篇文章就带你掌握几个核心点,让你轻松应对日常开发中的JSON处理。

结构体字段标签(Tag)的使用
Go语言通过结构体的字段标签(Tag)来控制JSON序列化后的键名。默认情况下,结构体会以字段名为小写形式作为JSON的键,但我们可以用json:"xxx"来自定义:

type User struct {
Name string `json:"name"`
Age int `json:"age"`
Email string `json:"email,omitempty"` // omitempty 表示如果为空则不输出该字段
}-
标签语法: 标签值由空格分隔多个选项,第一个是目标格式名称(这里是
json),后面可跟选项如omitempty。 -
常用选项:
-
omitempty:当字段为空(零值)时不包含进JSON输出 -
-:忽略该字段,不参与序列化/反序列化
-
这样你就可以灵活地控制输出格式,比如返回API数据时去掉敏感字段或空字段。
立即学习“go语言免费学习笔记(深入)”;
序列化:将结构体转为JSON字符串
使用json.Marshal()可以将结构体转换成JSON字节切片:

user := User{
Name: "Alice",
Age: 25,
Email: "",
}
data, _ := json.Marshal(user)
fmt.Println(string(data)) // {"name":"Alice","age":25}注意:
- 如果结构体中有字段被标记了
omitempty且其值为零值(如空字符串、0、nil等),则不会出现在最终结果中。 - 错误处理很重要,虽然上面用了
_忽略错误,但在生产代码中应检查是否出错。
如果你希望输出带缩进的美观格式(调试时很有用),可以用json.MarshalIndent()。
反序列化:将JSON解析为结构体
将JSON字符串还原为Go结构体也很简单,只需要调用json.Unmarshal()函数:
jsonData := `{"name":"Bob","age":30}`
var user User
json.Unmarshal([]byte(jsonData), &user)几点需要注意:
- 第二个参数必须是指针,否则不会修改原始变量
- JSON字段名要与结构体字段标签匹配(大小写不敏感)
- 多余的JSON字段不会报错,只是被忽略;缺少字段也不会影响解析
如果不知道具体结构,也可以使用map[string]interface{}或interface{}进行泛化解析:
var data map[string]interface{}
json.Unmarshal(jsonBytes, &data)适用于动态内容或配置文件读取等场景。
嵌套结构与复杂类型处理
结构体嵌套也是常见情况,比如一个用户可能有地址信息:
type Address struct {
City string `json:"city"`
Zip string `json:"zip"`
}
type User struct {
Name string `json:"name"`
Address Address `json:"address"`
}序列化和反序列化对嵌套结构也完全支持,只要结构一致就能正常工作。
另外,像数组、切片、指针等类型也能很好地处理:
type Result struct {
Tags []string `json:"tags"`
}基本上就这些。Golang处理JSON的方式简洁又强大,标准库已经能满足大部分需求。只要掌握了结构体标签、基本的序列化和反序列化方法,以及如何处理嵌套结构,就可以在实际项目中游刃有余了。










