
本文详解如何利用 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 处理代码的关键。










