如何使用 go-simplejson 遍历并拆分 JSON 文件中的数组项_技术教程

本文详解如何利用 go-simplejson 库解析嵌套 json，遍历数组元素，并将每个对象单独序列化为独立的格式化 json 文件。

在 Go 中处理动态或结构不确定的 JSON 时，go-simplejson 是一个轻量、灵活的第三方库，特别适合快速遍历和修改嵌套数据。针对如下典型结构的 JSON 文件：

{
  "data": {
    "docs": [
      {"key00": "val00", "key01": "val01"},
      {"key10": "val10", "key11": "val11"}
    ]
  }
}

目标是将 data.docs 数组中的每个对象分别写入独立文件（如 file0.json、file1.json），且保持格式美观（缩进、换行）。

✅ 核心步骤：遍历 + 类型断言 + 逐键赋值

simplejson.Get(...).MustArray() 返回的是 []interface{}，其中每个元素实际是 map[string]interface{}（对应 JSON 对象）。由于 simplejson 不提供直接“克隆”或“展开”原始 map 的方法，需手动遍历键值对，并用 out.Set(k, v) 写入新实例：

package main

import (
    "bytes"
    "fmt"
    "io/ioutil"
    "log"

    simplejson "github.com/bitly/go-simplejson"
)

func main() {
    j, err := ioutil.ReadFile("input.json")
    if err != nil {
        log.Fatal("读取文件失败:", err)
    }

    dec, err := simplejson.NewFromReader(bytes.NewReader(j))
    if err != nil {
        log.Fatal("解析 JSON 失败:", err)
    }

    docs := dec.Get("data").Get("docs").MustArray()
    for i, doc := range docs {
        out := simplejson.New()

        // 关键：类型断言为 map[string]interface{}
        m, ok := doc.(map[string]interface{})
        if !ok {
            log.Printf("警告：第 %d 项不是合法对象，跳过", i)
            continue
        }

        // 遍历键值对并写入新 simplejson 实例
        for k, v := range m {
            out.Set(k, v)
        }

        // 序列化为格式化 JSON（带缩进）
        b, err := out.EncodePretty()
        if err != nil {
            log.Printf("序列化第 %d 项失败: %v", i, err)
            continue
        }

        filename := fmt.Sprintf("file%d.json", i)
        if err := ioutil.WriteFile(filename, b, 0644); err != nil {
            log.Printf("写入 %s 失败: %v", filename, err)
            continue
        }
        fmt.Printf("✅ 已生成 %s\n", filename)
    }
}

? 提示：out.Set(k, v) 能自动处理嵌套结构（如 v 是 map 或 slice），无需递归处理。

⚠️ 注意事项与最佳实践

务必做类型断言检查：doc.(map[string]interface{}) 可能 panic，生产环境应加 ok 判断（如上所示）；
错误处理不可省略：ioutil.WriteFile 和 out.EncodePretty() 均可能失败，避免静默丢弃错误；
权限设置建议用 0644：0777 存在安全风险，普通 JSON 文件无需执行权限；
JSON 语法校验：原始示例中 "key10", "val10" 是非法语法，正确应为 "key10": "val10" —— 使用 json.Unmarshal 或在线校验器提前验证输入；
性能考量：若 JSON 结构固定且已知，推荐使用标准库 encoding/json + struct（如答案中 DataLayout 示例），它更高效、类型安全、内存占用更低；
调试技巧：不确定运行时类型？插入 fmt.Printf("DEBUG: %#v\n", doc) 快速查看底层结构。

✅ 替代方案：标准库 struct 解析（推荐用于确定结构）

当数据模式稳定时，优先选用标准库：

type DataLayout struct {
    Data struct {
        Docs []map[string]string `json:"docs"`
    } `json:"data"`
}

// 解析后直接 range + json.MarshalIndent 即可，无类型断言、无依赖、零开销。

综上，go-simplejson 在动态场景下极具表达力；而掌握其与标准库的适用边界，是写出健壮、可维护 JSON 处理代码的关键。