如何使用Golang encoding/json解析JSON_Golang encoding/json解析与序列化示例
发布时间 - 2026-01-01 00:00:00 点击率:次Go 的 encoding/json 包要求结构体字段导出(首字母大写)才能解析,非导出字段被静默跳过;需用 json:"key" 标签显式映射,支持蛇形转驼峰但有限制;数组/对象须严格对应切片/struct;空值处理推荐 *T 或 json.RawMessage;混合类型应先用 map[string]json.RawMessage 延迟解析。
Go 的 encoding/json 包能直接将 JSON 映射为结构体,但前提是字段名匹配且导出(首字母大写),否则解析会静默失败或字段为空。
结构体字段必须导出才能被 json.Unmarshal 处理
Go 的反射机制无法访问非导出字段(小写开头),json.Unmarshal 会跳过它们,不报错也不赋值。
- 确保结构体字段首字母大写,例如
UserName而非userName - 用
json标签显式指定 JSON 键名,大小写无关:UserName string `json:"user_name"` - 如果 JSON 键是
"user_id",而结构体字段是UserID int,不加标签也能解析成功(Go 默认做蛇形转驼峰),但这是有限制的:仅支持简单下划线分隔,不支持多下划线或数字混排(如"user_id_v2"不会自动转成UserIDV2)
处理嵌套对象与切片时,类型必须严格对应
JSON 数组必须映射为 Go 切片([]T)
,JSON 对象必须映射为 struct 或 map[string]interface{};类型错配会导致 json.Unmarshal 返回 invalid character 或 cannot unmarshal object into Go value of type []xxx 类错误。
- 嵌套结构体需定义对应子 struct,不能用
interface{}除非你后续手动断言 - JSON 中可能缺失的字段,建议用指针类型(如
*string)或加omitempty标签避免零值干扰 - 若不确定某字段是对象还是字符串(如某些 API 返回
"data": {}或"data": "null"),优先用json.RawMessage延迟解析
反序列化空值、null 和缺失字段的差异
JSON 中的 null、字段不存在、空字符串,在 Go 结构体中表现不同,直接影响业务逻辑判断。
立即学习“go语言免费学习笔记(深入)”;
-
string字段遇到 JSONnull→ 解析失败(invalid character 'n' looking for beginning of value),除非字段类型是*string -
*string遇到null→ 指针为nil;遇到缺失字段 → 也是nil;二者无法区分,需靠业务约定或额外字段标识 -
sql.NullString可区分Valid == false(null 或缺失)和Valid == true && String == ""(空字符串),适合对接数据库场景
type User struct {
ID int64 `json:"id"`
Name string `json:"name"`
Avatar *string `json:"avatar,omitempty"`
Metadata json.RawMessage `json:"metadata"`
}
data := []byte(`{"id": 123, "name": "alice", "avatar": null}`)
var u User
err := json.Unmarshal(data, &u)
// u.Avatar == nil,u.Metadata == json.RawMessage("null") —— 注意:RawMessage 不会解析,保留原始字节
真正麻烦的是混合类型字段(比如某个字段有时是对象、有时是字符串),这时候别硬套 struct,先用 map[string]json.RawMessage 提取再按需解析,否则容易 panic 或丢数据。
# js
# json
# go
# golang
# 字节
# sql
# String
# Object
# NULL
# for
# 字符串
# 结构体
# int
# 指针
# 指针类型
# Struct
# Interface
# 切片
# nil
# map
# 对象
# 数据库
# 下划线
# 首字母
# 先用
# 跳过
# 的是
# 也不
# 是有
# 也能
# 空字符串
# 不存在
相关栏目:
【
网站优化151355 】
【
网络推广146373 】
【
网络技术251813 】
【
AI营销90571 】
相关推荐:
Laravel的HTTP客户端怎么用_Laravel HTTP Client发起API请求教程
如何在腾讯云服务器上快速搭建个人网站?
Laravel如何使用Scope本地作用域_Laravel模型常用查询逻辑封装技巧【手册】
javascript如何操作浏览器历史记录_怎样实现无刷新导航
使用spring连接及操作mongodb3.0实例
如何快速搭建支持数据库操作的智能建站平台?
重庆市网站制作公司,重庆招聘网站哪个好?
Edge浏览器提示“由你的组织管理”怎么解决_去除浏览器托管提示【修复】
大型企业网站制作流程,做网站需要注册公司吗?
如何获取上海专业网站定制建站电话?
如何用PHP快速搭建高效网站?分步指南
js实现点击每个li节点,都弹出其文本值及修改
如何快速搭建FTP站点实现文件共享?
如何在沈阳梯子盘古建站优化SEO排名与功能模块?
如何在IIS管理器中快速创建并配置网站?
如何实现javascript表单验证_正则表达式有哪些实用技巧
米侠浏览器网页图片不显示怎么办 米侠图片加载修复
Python并发异常传播_错误处理解析【教程】
Linux虚拟化技术教程_KVMQEMU虚拟机安装与调优
微信公众帐号开发教程之图文消息全攻略
Laravel怎么实现观察者模式Observer_Laravel模型事件监听与解耦开发【指南】
为什么php本地部署后css不生效_静态资源加载失败修复技巧【技巧】
奇安信“盘古石”团队突破 iOS 26.1 提权
如何快速使用云服务器搭建个人网站?
教你用AI润色文章,让你的文字表达更专业
Laravel如何使用Sanctum进行API认证?(SPA实战)
Laravel怎么配置S3云存储驱动_Laravel集成阿里云OSS或AWS S3存储桶【教程】
Python文本处理实践_日志清洗解析【指导】
如何快速搭建虚拟主机网站?新手必看指南
高防服务器:AI智能防御DDoS攻击与数据安全保障
再谈Python中的字符串与字符编码(推荐)
北京网页设计制作网站有哪些,继续教育自动播放怎么设置?
Laravel路由Route怎么设置_Laravel基础路由定义与参数传递规则【详解】
香港服务器WordPress建站指南:SEO优化与高效部署策略
Laravel事件监听器怎么写_Laravel Event和Listener使用教程
成都品牌网站制作公司,成都营业执照年报网上怎么办理?
Laravel怎么实现前端Toast弹窗提示_Laravel Session闪存数据Flash传递给前端【方法】
如何用虚拟主机快速搭建网站?详细步骤解析
Laravel Blade组件怎么用_Laravel可复用视图组件的创建与使用
Laravel中的withCount方法怎么高效统计关联模型数量
免费视频制作网站,更新又快又好的免费电影网站?
Laravel安装步骤详细教程_Laravel环境搭建指南
Laravel怎么发送邮件_Laravel Mail类SMTP配置教程
javascript日期怎么处理_如何格式化输出
Laravel如何实现多级无限分类_Laravel递归模型关联与树状数据输出【方法】
Laravel如何将应用部署到生产服务器_Laravel生产环境部署流程
JavaScript如何实现音频处理_Web Audio API如何工作?
Laravel如何处理跨站请求伪造(CSRF)保护_Laravel表单安全机制与令牌校验
Laravel API资源(Resource)怎么用_格式化Laravel API响应的最佳实践
Laravel如何配置中间件Middleware_Laravel自定义中间件拦截请求与权限校验【步骤】

