讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Seko
Seko

AI短剧一键生成成片

如何在 Go 中递归遍历任意嵌套的 JSON 数据(无结构体定义)

千墨大大_3911

千墨大大_3911

发布时间:2026-02-03 21:16:02

|

738人浏览过

|

来源于php中文网

原创

如何在 Go 中递归遍历任意嵌套的 JSON 数据(无结构体定义)

本文介绍如何使用 map[string]interface{} 和类型断言,配合递归函数,高效、安全地遍历动态结构的多层嵌套 json,无需预定义 struct,适用于配置解析、日志分析等场景。

在 Go 中处理未知结构的 JSON(即“任意嵌套 JSON”)时,无法依赖固定 struct,而应采用 encoding/json 包提供的通用解码方式:将 JSON 解析为 map[string]interface{}(顶层对象)和 []interface{}(数组),再通过类型断言(Type Assertion) 和 类型开关(Type Switch) 识别并递归处理每种数据类型。

核心思路是:对每个值进行运行时类型判断——若为 map[string]interface{},则递归遍历其键值对;若为 []interface{},则递归遍历其元素;其余基础类型(如 string、float64、bool、nil)直接处理。这种模式天然支持任意深度嵌套,且代码简洁可维护。

以下为完整、健壮的实现示例:

cn-json-diff
cn-json-diff

比较两个 JSON 文件并显示差异。支持嵌套结构、数组及值变更。纯 Python 标准库实现,无需 API 密钥。

下载
package main

import (
    "encoding/json"
    "fmt"
)

func main() {
    var m map[string]interface{}
    if err := json.Unmarshal([]byte(input), &m); err != nil {
        panic(err)
    }
    parseMap(m, "")
}

// parseMap 递归解析 map[string]interface{},prefix 用于打印缩进(可选)
func parseMap(m map[string]interface{}, prefix string) {
    for key, val := range m {
        fullKey := prefix + key
        switch v := val.(type) {
        case map[string]interface{}:
            fmt.Printf("%s: (object)\n", fullKey)
            parseMap(v, fullKey+".") // 进入下一层,添加点号分隔
        case []interface{}:
            fmt.Printf("%s: (array, %d items)\n", fullKey, len(v))
            parseArray(v, fullKey+".")
        case string:
            fmt.Printf("%s: %q\n", fullKey, v)
        case float64: // JSON 数字默认为 float64
            fmt.Printf("%s: %g\n", fullKey, v)
        case bool:
            fmt.Printf("%s: %t\n", fullKey, v)
        case nil:
            fmt.Printf("%s: null\n", fullKey)
        default:
            fmt.Printf("%s: %v (type %T)\n", fullKey, v, v)
        }
    }
}

// parseArray 递归解析 []interface{}
func parseArray(a []interface{}, prefix string) {
    for i, val := range a {
        indexKey := fmt.Sprintf("%s[%d]", prefix, i)
        switch v := val.(type) {
        case map[string]interface{}:
            fmt.Printf("%s: (object)\n", indexKey)
            parseMap(v, indexKey+".")
        case []interface{}:
            fmt.Printf("%s: (array, %d items)\n", indexKey, len(v))
            parseArray(v, indexKey+".")
        case string:
            fmt.Printf("%s: %q\n", indexKey, v)
        case float64:
            fmt.Printf("%s: %g\n", indexKey, v)
        case bool:
            fmt.Printf("%s: %t\n", indexKey, v)
        case nil:
            fmt.Printf("%s: null\n", indexKey)
        default:
            fmt.Printf("%s: %v (type %T)\n", indexKey, v, v)
        }
    }
}

const input = `
{
  "outterJSON": {
    "innerJSON1": {
      "value1": 10,
      "value2": 22,
      "InnerInnerArray": ["test1", "test2"],
      "InnerInnerJSONArray": [{"fld1": "val1"}, {"fld2": "val2"}]
    },
    "InnerJSON2": "NoneValue"
  }
}`

✅ 关键优势说明:

  • 完全动态:不依赖任何预定义 struct,适配任意 JSON Schema;
  • 类型安全:通过 switch v := val.(type) 精确识别 map、slice、基础类型,避免 panic;
  • 可扩展性强:轻松添加新类型处理逻辑(如 int, int64 —— 注意 JSON 解析后整数也转为 float64);
  • 调试友好:输出带路径前缀(如 outterJSON.innerJSON1.fld1),便于定位字段;
  • 生产就绪:已处理 nil、布尔、浮点数等边界情况,符合 JSON 规范。

⚠️ 注意事项:

  • Go 的 json.Unmarshal 将所有数字统一解析为 float64,如需严格整型,应在业务逻辑中显式转换(例如 int(v.(float64))),并注意精度风险;
  • 若 JSON 极深(>1000 层),需警惕递归栈溢出,此时可改用显式栈([]interface{} 模拟)实现迭代版本;
  • 对性能极致敏感场景(如高频日志解析),可考虑 github.com/tidwall/gjson(零内存分配、极速查询),但会牺牲遍历灵活性。

掌握此模式,你便拥有了处理任意 JSON 结构的“瑞士军刀”——无论是提取所有字符串字段、查找特定 key、统计嵌套层级,还是构建通用 JSON 转换器,都可在此基础上快速扩展。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

539

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

616

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1276

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

791

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1846

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

5314

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

2474

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

4326

2025.06.17

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.3万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn