Go解析JSON需先os.ReadFile读字节再json.Unmarshal,结构体字段须大写并配json tag;写入用json.MarshalIndent加缩进;动态JSON用类型断言需逐层检查;大文件应使用json.Decoder流式解析。

用 json.Unmarshal 解析 JSON 文件内容
Go 读取 JSON 文件本质是「先读字节流,再反序列化」,不能跳过 os.ReadFile 直接传文件路径给 json.Unmarshal。常见错误是试图把 *os.File 直接塞进 json.Unmarshal,结果报 cannot unmarshal object into Go value of type * —— 因为它只接受 []byte 或 io.Reader。
正确做法分两步:
- 用
os.ReadFile("config.json")获取原始字节(注意路径是否含空格或中文,Windows 下尤其要检查) - 传给
json.Unmarshal(data, &v),其中v必须是指针,且字段首字母大写(否则无法导出、解析失败)
示例结构体要匹配 JSON 键名,如 JSON 含 "user_name",结构体字段得加 tag:UserName string `json:"user_name"`。漏掉 tag 或大小写不一致,字段会保持零值。
用 json.MarshalIndent 生成可读 JSON 文件
写 JSON 文件时,json.Marshal 输出的是紧凑格式(无换行缩进),调试困难;直接用 json.MarshalIndent 更实用。它比 Marshal 多两个参数:prefix(每行前缀)和 indent(缩进符),常用 "", " "。
立即学习“go语言免费学习笔记(深入)”;
注意三点:
- 写入前务必用
os.WriteFile(filename, data, 0644),权限设错(如0777)在 Linux 下可能引发安全警告 - 如果结构体含
time.Time、map[interface{}]interface{}等非原生类型,json.Marshal会 panic,需提前转换或实现json.Marshaler接口 - 浮点数默认保留小数,若 JSON 中需整数但 Go 用
float64字段接收,解析后仍是123.0,需手动转int或用json.Number
处理嵌套对象与切片时的类型断言陷阱
当 JSON 结构不确定(比如 API 返回动态字段),常会用 map[string]interface{} 或 []interface{} 接收。但后续取值必须逐层做类型断言,否则运行时报 panic: interface conversion: interface {} is map[string]interface {}, not []interface{}。
典型错误写法:users := data["users"].([]interface{}) —— 如果 data["users"] 实际是 nil 或字符串,断言直接崩溃。
安全做法是:
- 先检查键是否存在:
if users, ok := data["users"]; ok - 再断言类型:
if userList, ok := users.([]interface{}); ok - 遍历内部项时,每个元素仍需再次断言,例如
userMap := item.(map[string]interface{})
更稳的方式是定义具体结构体 + 使用 json.RawMessage 延迟解析某字段,避免层层断言。
用 json.Decoder 流式解析大 JSON 文件
单个 JSON 文件超过几 MB,用 json.Unmarshal 一次性加载到内存容易 OOM。json.Decoder 支持从 *os.File 或 io.Reader 流式解码,边读边解析,内存占用稳定。
关键点:
- 创建解码器:
dec := json.NewDecoder(f),f是已打开的*os.File - 对数组型 JSON(如
[{...},{...}]),需先调dec.Decode(&count)跳过开头[,或用json.RawMessage暂存整个数组再拆分 - 对超大对象,可用
dec.Token()手动推进解析器,识别{、}、键名等,适合自定义跳过某些字段
流式解析不自动校验 JSON 完整性,文件末尾截断可能静默失败,建议配合 io.ReadSeeker 做长度校验。










