Go语言中嵌套结构体JSON序列化失败的解决方案

梦磊吖_5516

梦磊吖_5516

2025-12-26

432人浏览

原创

Go语言中嵌套结构体JSON序列化失败的解决方案

go的json.marshal函数只能序列化导出(首字母大写)的结构体字段,小写字段默认不可见,导致输出空对象{},需将字段名首字母大写或自定义marshaljson方法。

在Go语言中,encoding/json包对结构体进行JSON序列化时遵循严格的可见性规则:只有首字母大写的导出字段(exported fields)才能被外部包(如json)访问并序列化;而小写字母开头的字段属于未导出(unexported)成员,在json.Marshal调用时会被忽略,最终生成空JSON对象(如{})。

以原代码为例,Configitem和GuiConfig的所有字段均为小写(如local_address、configs),因此json.Marshal(config1)返回{}——并非程序崩溃,而是“静默跳过”所有字段。

✅ 正确做法是将结构体字段改为导出形式(首字母大写),并可配合json标签明确字段名,提升可读性与兼容性:

type Configitem struct {
    LocalAddress string `json:"local_address"`
    LocalPort    int    `json:"local_port"`
    Method       string `json:"method"`
    Password     string `json:"password"`
    Server       string `json:"server"`
    ServerPort   string `json:"server_port"`
    Timeout      int    `json:"timeout"`
}

type GuiConfig struct {
    Configs []*Configitem `json:"configs"`
    Index   int           `json:"index"`
}

修改后,json.Marshal(config1)将正确输出:

github-image-hosting
github-image-hosting

将图片上传至 img402.dev,以便嵌入 GitHub PR、Issue 和评论中。免费套餐(最大 1MB,保留 7 天,无需身份验证)为默认选项;付费套餐支持最大 5MB,并可通过 x402 实现 1 年(

修改后,json.Marshal(config1)将正确输出:

.01)或永久()保留。当智能体需要在 GitHub 场景中分享图片时使用——例如截图、原型图、流程图,或其他任何视觉内容。触发条件包括:“截图当前页面”、“附加一张图片”、“将截图添加到该 PR 中”、“上传此原型图”,或任何生成需用于 GitHub 的图片的任务。
下载
{"configs":[{"local_address":"eouoeu","local_port":111,"method":"eoeoue","password":"ouoeu","server":"oeuoeu","server_port":"qoeueo","timeout":3333}],"index":1}

⚠️ 注意事项:

  • 即使添加了json标签,字段仍必须导出(大写首字母),否则标签无效;
  • 若因封装需求必须保留字段私有(如避免外部直接修改),可为结构体实现json.Marshaler接口,自定义序列化逻辑;
  • 建议始终为导出字段添加json标签,显式控制JSON键名,避免结构体字段名变更影响API兼容性。

总结:Go的JSON序列化不是“反射所有字段”,而是“仅反射导出字段”。牢记 “小写=私有=JSON不可见” 这一原则,是避免此类问题的关键。

golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

word js git json go语言

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2235

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3602

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1196

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4139

7

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

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

2025.06.09

5134

18

golang结构体方法
golang结构体方法

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

2025.07.04

5311

25

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

3208

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

5229

12

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2025.12.29

3869

9

热门下载

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

精品课程

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

共101课时 | 21.3万人学习

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

共39课时 | 4.9万人学习