Go语言用encoding/json包实现JSON解析与生成,需掌握结构体标签映射、json.Unmarshal/Marshal用法、omitempty空值处理、嵌套数组对应及类型精度控制等核心要点。

Go语言内置的encoding/json包提供了简洁高效的JSON解析与生成能力,无需第三方依赖即可完成结构化数据的读写。关键在于理解Go类型与JSON之间的映射规则,并合理使用结构体标签(struct tags)控制序列化行为。
定义结构体并映射JSON字段
Go中通过结构体(struct)表示JSON对象,字段名默认需首字母大写(导出)才能被json包访问。使用json:"field_name"标签指定对应JSON键名,支持别名、忽略字段、空值处理等:
-
字段映射:如
Name string `json:"name"`将Go字段Name映射为JSON中的"name" -
忽略字段:用
json:"-"跳过该字段(如敏感信息或临时计算字段) -
空值处理:加
omitempty(如Age int `json:"age,omitempty"`),当值为零值时不出现在输出JSON中
解析JSON字符串或文件
使用json.Unmarshal()将JSON字节切片([]byte)解析为Go结构体;若从文件读取,先用os.ReadFile()加载内容:
- 确保目标结构体字段可导出(首字母大写)
- 检查
Unmarshal返回的错误,JSON格式错误、字段类型不匹配都会导致失败 - 对不确定结构的JSON(如动态key),可用
map[string]interface{}或json.RawMessage延迟解析
生成JSON字符串或写入文件
用json.Marshal()将Go值转为JSON字节切片,再用string()转字符串,或直接写入文件:
立即学习“go语言免费学习笔记(深入)”;
-
json.MarshalIndent()可生成带缩进的易读JSON(适合调试或配置文件) - 写入文件时建议使用
os.WriteFile()(Go 1.16+)或os.Create()+json.NewEncoder().Encode() - 注意时间、自定义类型需实现
MarshalJSON()方法才能正确序列化
处理嵌套、数组和边界情况
JSON对象嵌套对应结构体嵌套字段;JSON数组对应Go切片([]T)。常见注意事项:
- JSON
null映射为Go的零值,如*string可接收null(变为nil) - 数字精度:JSON数字默认解析为
float64,若需整型或高精度,应显式定义字段类型并配合json.Number或第三方库 - 中文字符默认不转义,如需Unicode转义可用
json.Encoder.SetEscapeHTML(false)配合自定义encoder
不复杂但容易忽略细节,掌握结构体标签、错误检查和类型对应关系,就能稳健处理大多数JSON场景。










