0

0

如何使用Golang实现JSON文件读写_序列化和反序列化数据

P粉602998670

P粉602998670

发布时间:2025-12-21 20:54:33

|

574人浏览过

|

来源于php中文网

原创

Go语言用encoding/json包实现JSON序列化与反序列化,需通过结构体标签(如json:"name"、omitempty)控制字段映射,配合os.ReadFile/WriteFile完成文件读写,注意指针传递、错误检查及类型一致性。

如何使用golang实现json文件读写_序列化和反序列化数据

Go语言内置的encoding/json包提供了简洁高效的JSON序列化(marshal)和反序列化(unmarshal)能力,配合os包可轻松完成JSON文件的读写。核心在于结构体标签(struct tags)与数据类型的正确映射。

定义结构体并设置JSON标签

要让Go正确处理JSON字段名、忽略空值或可选字段,需在结构体字段后添加json:标签:

  • json:"name":指定JSON中对应的字段名(支持小写)
  • json:"name,omitempty":该字段为空值(零值)时不参与序列化
  • json:"-" :完全忽略该字段
  • json:"name,string":将数值类型(如int)以字符串形式编解码(常用于API兼容)

示例结构体:

type User struct {
  ID int `json:"id"`
  Name string `json:"name"`
  Email string `json:"email,omitempty"`
  Active bool `json:"active"`
}

将结构体写入JSON文件(序列化)

使用json.Marshal将Go值转为字节切片,再用os.WriteFile保存到磁盘:

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

  • 先调用json.Marshal获取格式化的JSON字节;可选json.MarshalIndent生成带缩进的可读JSON
  • os.WriteFile(filename, data, 0644)写入文件(权限0644表示用户可读写,组和其他用户只读)
  • 务必检查error,如结构体含不可序列化的字段(如函数、channel)会报错

简明写法示例:

快写红薯通AI
快写红薯通AI

快写红薯通AI,专为小红书而生的AI写作工具

下载
user := User{ID: 1, Name: "Alice", Active: true}
data, err := json.MarshalIndent(user, "", " ")
if err != nil {
  log.Fatal(err)
}
err = os.WriteFile("user.json", data, 0644)
if err != nil {
  log.Fatal(err)
}

从JSON文件读取并解析为结构体(反序列化)

使用os.ReadFile加载文件内容,再用json.Unmarshal解析为结构体指针:

  • json.Unmarshal第二个参数必须是目标结构体的指针(&v),否则无效果
  • 若JSON字段多于结构体字段,多余字段被忽略;若字段少,对应结构体字段保持零值
  • 类型不匹配(如JSON字符串赋给int字段)会返回json.UnmarshalTypeError

示例:

data, err := os.ReadFile("user.json")
if err != nil {
  log.Fatal(err)
}
var user User
err = json.Unmarshal(data, &user)
if err != nil {
  log.Fatal(err)
}
fmt.Printf("%+v\n", user) // 输出:{ID:1 Name:"Alice" Email:"" Active:true}

处理嵌套、切片与动态JSON

JSON中的对象数组、嵌套对象可直接映射为Go切片或嵌套结构体:

  • JSON数组 [{"name":"A"},{"name":"B"}][]User
  • 嵌套对象 {"profile":{"age":25}} → 字段类型为Profile ProfileInfo,其中ProfileInfo是另一结构体
  • 不确定结构时可用map[string]interface{}json.RawMessage延迟解析

例如解析含用户列表的JSON:

type Response struct {
  Users []User `json:"users"`
  Total int `json:"total"`
}
// 反序列化后可直接访问 response.Users[0].Name

不复杂但容易忽略细节:标签拼写、指针传递、错误检查和类型一致性是JSON读写稳定的关键。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

180

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

228

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

340

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

209

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

393

2024.05.21

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

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

197

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

191

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

273

2025.06.17

c++空格相关教程合集
c++空格相关教程合集

本专题整合了c++空格相关教程,阅读专题下面的文章了解更多详细内容。

0

2026.01.23

热门下载

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

精品课程

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

共101课时 | 8.5万人学习

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

共39课时 | 3.2万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号