展开菜单
首页 精品内容 本月促销 装机必备 Windows macOS软件 IOS软件 Android AI PDF教程 专题
全部分类

当前位置:

首页 > 编程开发 > Golang读取JSON文件技巧分享

Golang读取JSON文件技巧分享

小到配置文件、中等规模数据文件(100MB)用os.ReadFile+json.Unmarshal最简;超大文件或需流式解析时用json.NewDecoder;动态键名优先map[string]interface{};字段必须首字母大写并加json标签。

小到配置文件、中等规模数据文件(100MB)用os.ReadFile+json.Unmarshal最简;超大文件或需流式解析时用json.NewDecoder;动态键名优先map[string]interface{};字段必须首字母大写并加json标签。

Golang如何读取JSON文件_Golang JSON文件解析技巧

os.ReadFile + json.Unmarshal 是最简方案

小到配置文件、中等规模的数据文件(<10MB),直接读字节再解码是最自然、最不容易出错的方式。Go 1.16+ 推荐用 os.ReadFile,它一步到位返回 []byte,避免手动开文件、defer、错误传播的样板代码。

  • json.Unmarshal 原生支持 []byte,**千万别先转成 string 再传进去**——多一次内存拷贝,且对含 Unicode 的 JSON 没额外好处
  • 结构体字段必须首字母大写(导出),否则 json 包静默跳过,字段始终为零值
  • 务必显式加 json:"field_name" 标签,尤其当 JSON 用蛇形命名(如 db_host)而 Go 习惯驼峰(DBHost)时,不加标签会解析失败
data, err := os.ReadFile("config.json")
if err != nil {
    log.Fatal(err)
}
var cfg struct {
    DBHost string `json:"db_host"`
    DBPort int    `json:"db_port"`
}
if err := json.Unmarshal(data, &cfg); err != nil {
    log.Fatal("parse error:", err)
}

嵌套字段缺失?用指针或 json.RawMessage 区分“空”和“不存在”

JSON 中某个对象字段可能压根没出现({"user":{...}}),也可能显式为 null{"user":null}),还可能为空对象({"user":{}})。如果结构体字段是非指针类型(如 User User),这三种情况在 Go 里都会变成零值结构体,业务逻辑无法区分。

  • *User:字段为 nil 表示 JSON 中该 key 缺失或值为 null;非 nil 才真正有数据
  • json.RawMessage:保留原始字节,延迟解析,适合字段类型不确定(比如 "data" 有时是对象、有时是字符串)
  • 别依赖 omitempty 判断是否存在——它只控制序列化输出,不影响反序列化行为

大文件(>100MB)或流式场景?换 json.NewDecoder

当 JSON 文件体积很大,或者你只想解析其中一部分(比如一个巨型数组里的每个元素),json.Unmarshal 会把整个文件加载进内存,容易触发 OOM。

  • json.NewDecoder 基于 io.Reader,边读边解析,内存占用恒定
  • 适用于日志导入、ETL 脚本、API 流式响应体等场景
  • 注意:它一次只解一个顶层 JSON 值(如一个对象或一个数组),如果文件是纯 JSON 数组,需配合 Token() 或封装循环解析逻辑
f, _ := os.Open("huge.json")
decoder := json.NewDecoder(f)
var item MyItem
for decoder.Decode(&item) == nil {
    // 处理每个 item
}

动态键名或结构不确定?优先选 map[string]interface{},不是 interface{}

当你不知道 JSON 的 key 名(比如监控指标带时间戳前缀),或字段类型混杂("value" 有时是数字、有时是字符串),硬写结构体会很痛苦。

  • 直接解到 map[string]interface{},比先解到 interface{} 再断言成 map 少一层 panic 风险
  • 数组对应 []interface{},数字默认是 float64,需要 int(v.(float64)) 转换(注意精度)
  • 若后续还要序列化回去,确保所有值类型都符合 JSON 规范(如不能含 funcchannel

最容易被忽略的其实是字段导出规则和标签一致性——90% 的“解析不出来”问题,根源都在结构体字段小写了,或者漏了 json:"xxx"。别猜,打开文件用 jq . 看一眼原始结构,再对齐写结构体,比反复试错快得多。

本文内容来源于互联网,如有侵权请联系删除。
作者最新文章
编程开发
相关文章 更多
精品专题 更多
本月促销

正软商城本月促销专区,汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动,提供限时折扣、特价授权和优惠购买信息,活动库存及价格以页面实时展示为准。

装机必备

正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

Windows

正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

macOS软件

正软商城macOS软件专区,精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具,提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。

IOS软件

正软商城iOS软件专区,精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用,提供功能介绍、适用设备、系统要求和正版获取方式等信息。

AI

正软商城AI软件专区,汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具,提供功能介绍、适用平台、收费方式及正版购买信息。

PDF教程

正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

Mac软件 更多
灵活计算器
灵活计算器

灵活计算器是一款笔记式算数应用,支持实时计算、动态关联和云端同步功能。记录、整理和输出之间的过渡会更自然,适合长期写作、做笔记或持续沉淀个人内容。

赤友清理大师
赤友清理大师

赤友清理大师是一款为 Mac 设计的智能清理优化工具,可精准扫描垃圾、大文件、重复文件等,释放磁盘空间。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。

极度公式
极度公式

极度公式是一款跨平台专业LaTeX公式识别编辑软件,支持OCR公式识别和多平台编辑。和使用说明,避免使用,享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。

图几
图几

图几是一款适用于 macOS 的截图、标注与美化工具,支持离线操作保障隐私。界面整理和高频系统操作被放到一起考虑,桌面或窗口内容一多时,管理起来会更省心。

密码键盘
密码键盘

密码键盘是一款兼具安全性与便捷性的高效密码管理器。日常使用里的持续防护和信息管理会更突出,适合把安全控制放进长期使用流程中的场景。

思源笔记
思源笔记

思源笔记是一款本地笔记软件,提供所见即所得的编辑方式,为长文写作带来顺滑的体验。记录、整理和输出之间的过渡会更自然,适合长期写作、做笔记或持续沉淀个人内容。

Office 365 简体中文
Office 365 简体中文

一款文字处理软件,一种订阅式的跨平台办公软件,基于云平台提供多种服务,通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合,Office 365 可让任何人使用任何设备随时随地创建和共享内容。

WALTR PRO
WALTR PRO

WALTR是一款电脑至iOS文件传输转换工具,操作简单,快速实现文件识别与传送。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。

CodeExpander
CodeExpander

CodeExpander 是一款快捷短语输入增强工具,通过键入缩写自动展开为自定义文段,提升工作效率。任务管理和过程控制会更完整,持续下载、批量同步或需要稳定传输流程的场景会更适合它。

Mountain Duck
Mountain Duck

Mountain Duck 是一款能将多个网盘挂载到本地的工具,像本地磁盘一样使用网盘。清理链路的完整性会更好一些,做应用卸载、残留处理和空间整理时,通常能少走很多手动排查步骤。

Menuist
Menuist

Menuist 是一款面向 macOS 的 Finder 右键菜单增强工具,主要用来补充新建文件、快捷导航等常用操作,让日常文件管理和访问路径时更高效、更顺手。

Mole
Mole

Mole 是一款专为 Mac 设计的深度清理优化工具,涵盖缓存清理、应用管理及实时状态监控等功能。清理链路的完整性会更好一些,做应用卸载、残留处理和空间整理时,通常能少走很多手动排查步骤。

WINDOWS 更多
Windows 10
Windows 10

Windows 10 是一款微软推出的经典操作系统,拥有硬件兼容性与多任务处理能力。它更偏向把系统状态查看和常用调节动作放在一起,适合需要持续观察和微调设备状态的场景。

极度公式
极度公式

极度公式是一款跨平台专业LaTeX公式识别编辑软件,支持OCR公式识别和多平台编辑。和使用说明,避免使用,享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。

密码键盘
密码键盘

密码键盘是一款兼具安全性与便捷性的高效密码管理器。日常使用里的持续防护和信息管理会更突出,适合把安全控制放进长期使用流程中的场景。

思源笔记
思源笔记

思源笔记是一款本地笔记软件,提供所见即所得的编辑方式,为长文写作带来顺滑的体验。记录、整理和输出之间的过渡会更自然,适合长期写作、做笔记或持续沉淀个人内容。

傲梅轻松备份
傲梅轻松备份

傲梅轻松备份是一款专业易用的数据备份软件,为重要数据提供安全保障。日常使用里的持续防护和信息管理会更突出,适合把安全控制放进长期使用流程中的场景。

Office 365 简体中文
Office 365 简体中文

一款文字处理软件,一种订阅式的跨平台办公软件,基于云平台提供多种服务,通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合,Office 365 可让任何人使用任何设备随时随地创建和共享内容。

Wise Folder Hider Pro
Wise Folder Hider Pro

Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件,为私密数据添加多重保护。高频操作更强调就近处理,浏览、整理和跨目录移动文件时,来回切换和重复点击都会少很多。

WALTR PRO
WALTR PRO

WALTR是一款电脑至iOS文件传输转换工具,操作简单,快速实现文件识别与传送。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。

CodeExpander
CodeExpander

CodeExpander 是一款快捷短语输入增强工具,通过键入缩写自动展开为自定义文段,提升工作效率。任务管理和过程控制会更完整,持续下载、批量同步或需要稳定传输流程的场景会更适合它。

PinStack
PinStack

PinStack是一款轻量级的Windows平台剪贴板管理工具,优化您的剪贴板使用体验。它更偏向把系统状态查看和常用调节动作放在一起,适合需要持续观察和微调设备状态的场景。

Mountain Duck
Mountain Duck

Mountain Duck 是一款能将多个网盘挂载到本地的工具,像本地磁盘一样使用网盘。清理链路的完整性会更好一些,做应用卸载、残留处理和空间整理时,通常能少走很多手动排查步骤。

Seer
Seer

Seer是一款在Win平台下的空格键功能增强效率工具,只需轻敲空格键,就能预览几乎任何格式的文件。它更适合把零散的小功能集中起来使用,处理高频琐碎任务时会更省事。