讲师中心 微信公众号
AI工具推荐 视频效率加速

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

梦磊吖_5516

梦磊吖_5516

发布时间:2025-12-26 11:10:01

|

432人浏览过

|

来源于php中文网

原创

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 的图片的任务。

下载

立即学习“go语言免费学习笔记(深入)”;

{"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不可见” 这一原则,是避免此类问题的关键。

热门AI工具

更多
豆包大模型

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

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

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

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

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

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

相关专题

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

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

2235

2023.08.07

json是什么
json是什么

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

3582

2023.08.23

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

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

1196

2023.10.13

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

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

4119

2025.09.10

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

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

5114

2025.06.09

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

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

5271

2025.07.04

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

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

3208

2023.10.19

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

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

5209

2025.10.17

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

0

2026.11.02

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
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