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

Go语言中JSON序列化时结构体字段必须导出才能生效

老雪大大_6812

老雪大大_6812

发布时间:2026-01-18 14:17:03

|

952人浏览过

|

来源于php中文网

原创

Go语言中JSON序列化时结构体字段必须导出才能生效

在go中使用json.marshal序列化结构体切片时,若json输出为空对象(如[{},{}]),根本原因是结构体字段未导出(即首字母小写),导致json包无法访问这些字段。解决方法是将字段名首字母大写并合理使用json标签。

Go 的 encoding/json 包遵循严格的可见性规则:只有导出(exported)字段(即首字母大写的字段)才能被 JSON 编码/解码器访问。你原始定义中的 imsi、network 等字段均为小写开头,属于未导出字段,因此 json.Marshal 会忽略它们,仅生成空的 JSON 对象 {}。

✅ 正确做法如下:

  1. 将结构体字段首字母大写,使其导出;
  2. 通过 json struct tag 显式指定 JSON 键名,保持与预期的 JSON 字段命名一致(如使用下划线风格);
  3. (可选)为字段添加 omitempty 标签避免零值冗余输出。

修正后的类型定义示例:

type SpanInfo struct {
    IMSI          string `json:"imsi"`
    Network       string `json:"network"`
    NetworkStatus string `json:"network_status"`
    SignalQuality int    `json:"signal_quality"`
    Slot          int    `json:"slot"`
    State         string `json:"state"`
}

type GatewayInfo []SpanInfo

使用方式保持不变:

jm-jsjkxyjs02-pzl-803
jm-jsjkxyjs02-pzl-803

查询全球任意城市的实时天气和未来天气预报

下载

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

func getGatewayInfo(spans []SpanInfo) GatewayInfo {
    return GatewayInfo(spans)
}

// 示例初始化
spans := []SpanInfo{
    {IMSI: "652020105829193", Network: "20801", NetworkStatus: "Registered (Roaming)", SignalQuality: 17, Slot: 2, State: "active"},
    {IMSI: "652020105829194", Network: "20801", NetworkStatus: "Registered (Roaming)", SignalQuality: 16, Slot: 3, State: "active"},
}
gatewayInfo := getGatewayInfo(spans)

jsonInfo, err := json.Marshal(gatewayInfo)
if err != nil {
    log.Fatal("JSON marshal error:", err)
}
log.Printf("jsonInfo: %s", jsonInfo)
// 输出示例:
// [{"imsi":"652020105829193","network":"20801","network_status":"Registered (Roaming)","signal_quality":17,"slot":2,"state":"active"},...]

⚠️ 注意事项:

  • 若字段为指针或嵌套结构体,同样需确保其内部字段导出;
  • json:"-" 可完全忽略某字段;json:"field,omitempty" 在字段为零值时省略该键;
  • 切片类型 GatewayInfo []SpanInfo 本身无需额外实现接口,json.Marshal 原生支持切片序列化;
  • 日志中用 %v 打印结构体可清晰查看字段值,而 %s 仅适用于字符串——避免误用格式动词影响调试判断。

总结:Go 的 JSON 序列化不是“自动反射所有字段”,而是基于导出性 + struct tag 的显式契约。养成从设计阶段就规范字段命名与标签的习惯,是写出健壮序列化逻辑的关键前提。

热门AI工具

更多
蛙蛙写作

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

DeepSeek

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

豆包大模型

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

Atoms
Atoms Hot

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

WorkBuddy

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

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

Laper
Laper Hot

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

讯飞智作

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

相关专题

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

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

1975

2023.08.07

json是什么
json是什么

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

2722

2023.08.23

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

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

936

2023.10.13

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

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

3059

2025.09.10

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1578

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2284

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

5804

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

4929

2023.11.24

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

160

2026.09.23

热门下载

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

精品课程

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

共101课时 | 20.6万人学习

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

共39课时 | 4.7万人学习

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

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