本文详解 Go 语言中 encoding/json 包解析 JSON 数据的核心要点，包括结构体字段必须首字母大写（导出）、JSON 数组逐项反序列化方法，以及常见错误“unable to unmarshal” 的根本原因与修复方案。
本文详解 go 语言中 `encoding/json` 包解析 json 数据的核心要点，包括结构体字段必须首字母大写（导出）、json 数组逐项反序列化方法，以及常见错误“unable to unmarshal” 的根本原因与修复方案。
在 Go 中使用 json.Unmarshal 解析 JSON 数据时，一个高频且易被新手忽略的关键约束是：只有导出（exported）字段才能被 encoding/json 包访问和赋值。所谓导出字段，即结构体中以大写字母开头的字段名（如 Offset），Go 的反射机制仅允许对导出字段进行读写；而小写开头的字段（如 offset）属于非导出字段，json 包无法访问，因此反序列化时会静默跳过，最终导致结构体字段保持零值，甚至在严格模式下（如嵌套结构或类型不匹配时）直接返回 json: cannot unmarshal ... 错误。
正确的结构体定义必须将字段名首字母大写，并通过 json 标签显式映射 JSON 键名（推荐，增强可维护性）：
type DisassembleOutput struct {
Offset int `json:"offset"`
FcnAddr int `json:"fcn_addr"`
FcnLast int `json:"fcn_last"`
Size int `json:"size"`
Opcode string `json:"opcode"`
Bytes string `json:"bytes"`
Type string `json:"type,omitempty"` // 可选字段，JSON 中缺失时忽略
TypeNum int `json:"type_num,omitempty"`
Flags []string `json:"flags,omitempty"`
Comment string `json:"comment,omitempty"`
}注意：Fcn_addr → FcnAddr 是 Go 命名惯例（驼峰式），配合 json:"fcn_addr" 标签实现语义清晰与协议兼容的统一。
你提供的 JSON 片段实为JSON 数组（以 [ 开头），但内容中省略了方括号 —— 完整数据应形如：
立即学习“go语言免费学习笔记（深入）”；
[
{ "offset": 4224368, "fcn_addr": 4224368, ... },
{ "offset": 4224370, "fcn_addr": 4224368, ... }
]因此，不能直接 json.Unmarshal([]byte(data), &v) 到单个结构体变量，而应解码为结构体切片：
var outputs []DisassembleOutput
err := json.Unmarshal([]byte(jsonData), &outputs)
if err != nil {
log.Fatal("JSON 解析失败:", err)
}
fmt.Printf("成功解析 %d 条指令\n", len(outputs))
for i, out := range outputs {
fmt.Printf("第%d条: offset=%d, opcode=%s\n", i+1, out.Offset, out.Opcode)
}若需逐项解析（例如流式处理超大 JSON 数组以节省内存），可使用 json.Decoder 配合循环：
decoder := json.NewDecoder(strings.NewReader(jsonData))
// 先读取 '['
_, err := decoder.Token()
if err != nil {
log.Fatal(err)
}
// 循环读取每个对象
for decoder.More() {
var item DisassembleOutput
if err := decoder.Decode(&item); err != nil {
log.Fatal("解析单项失败:", err)
}
fmt.Printf("解析单项: %+v\n", item)
}
// 读取 ']'
_, err = decoder.Token()⚠️ 重要注意事项：
- 字段必须导出：这是 90% “unmarshal 失败” 问题的根源，与字段类型、JSON 格式无关；
- JSON 键名区分大小写，标签中的字符串必须完全匹配（如 "offset" 不等于 "Offset"）；
- 使用 omitempty 可避免零值字段参与序列化，也支持反序列化时跳过缺失字段；
- 若 JSON 中存在结构体未定义的字段，json 包默认忽略；如需捕获未知字段，可嵌入 map[string]interface{} 或自定义 UnmarshalJSON 方法。
总结：Go 的 JSON 解析强调显式性与安全性。牢记「大写字母导出 + 标签映射 + 切片接收数组」三原则，即可稳健处理绝大多数 JSON 场景。
