Go 语言 JSON 处理核心是 encoding/json 库,需掌握结构体标签、嵌套解析、错误处理及流式读写;字段须导出,用 json:"name" 映射,omitempty 忽略零值,inline 内嵌,RawMessage 延迟解析。

Go 语言处理 JSON 文件的核心是 标准库 encoding/json,关键在于理解结构体标签、嵌套数据解析、错误处理和流式读写。不需要第三方库,但得用对方法。
定义结构体并正确使用 JSON 标签
Go 通过结构体字段标签(如 json:"name")控制序列化 / 反序列化行为。字段必须首字母大写(导出),否则无法被 JSON 包访问。
- 基础映射:字段名不一致时用标签对齐,例如
UserName string `json:"user_name"` - 忽略字段:用
json:"-"完全跳过该字段;用json:",omitempty"在值为零值(空字符串、0、nil 等)时省略输出 - 嵌套结构:直接内嵌结构体或指针,JSON 会自动展开;若需保留原字段名,加
json:",inline"
读取 JSON 文件到结构体(反序列化)
推荐先用 os.ReadFile 一次性读入内存,再用 json.Unmarshal 解析。适合中小文件;大文件考虑 json.Decoder 流式解析。
- 检查错误不能省略:解析失败常见于字段类型不匹配、JSON 格式错误、未导出字段
- 支持多种输入源:文件、HTTP 响应体、字符串(用
strings.NewReader转换) - 示例:
err := json.Unmarshal(data, &user),user必须是指针
将结构体写入 JSON 文件(序列化)
用 json.Marshal 得到 字节 切片,再写入文件;需要 格式化输出(带缩进)则用 json.MarshalIndent。
立即学习“go 语言免费学习笔记(深入)”;
- 写文件前确保目录存在:
os.MkdirAll(filepath.Dir(filename), 0755) - 写入后调用
file.Sync()可选,确保数据落盘(尤其日志类场景) - 中文不转义:设置
json.Encoder.SetEscapeHTML(false)(配合json.NewEncoder使用)
处理动态或未知结构的 JSON
当字段不确定或需灵活遍历时,用 map[string]interface{} 或 json.RawMessage 延迟解析。
-
json.RawMessage是字节切片别名,可暂存未解析的 JSON 片段,避免重复解码 - 解析后类型断言要谨慎,建议配合
errors.Is或类型检查(如v, ok := data["items"].([]interface{})) - 复杂嵌套推荐先用在线 工具(如 json-to-go)生成结构体,再手动调整标签
基本上就这些。Golang 的 JSON 处理不复杂但容易忽略标签和导出规则,写几个小例子跑通一遍,后面就顺了。