Golang JSON 解析：结构体字段导出与数组解析完全指南-Golang-PHP中文网

Golang JSON 解析：结构体字段导出与数组解析完全指南

本文详解 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 数组（以 [ 开头），但内容中省略了方括号 —— 完整数据应形如：

Json Repair Kit

使用 Node.js 评估修复格式错误的 JSON，自动纠正尾随逗号、单引号、未加引号的键等常见问题，实现文件规范化。

下载

[
  { "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 场景。