如何使用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 charactercannot 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 字段遇到 JSON null → 解析失败(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自定义中间件拦截请求与权限校验【步骤】