golang中encoding/json包的实现
更新时间：2025年07月02日 15:05:13 作者：草海桐
Go语言通过encoding/json包提供了对JSON数据的强大支持,本文主要介绍了golang中encoding/json包的实现,具有一定的参考价值,感兴趣的可以了解一下
Go 语言通过 encoding/json 包提供了对 JSON 数据的强大支持，包括序列化、反序列化、自定义处理、数组处理、任意结构解析以及流式处理等。
1. 基本使用
1.1 结构体字段与 JSON 的映射
在 Go 中，结构体的字段可以通过 json 标签（JSON Tag）与 JSON 字段进行映射。如果不指定 json 标签，默认使用结构体字段名的蛇形命名（小写）作为 JSON 字段名。
type P struct { // 未使用json标签，自动根据字段名称进行绑定
Name string
Age int
Address string
Sex string
Time time.Time
}
type Person struct {
Name string `json:"name"`
Age int `json:"age"`
Address string `json:"-"`
Sex string `json:"sex,omitempty"`
}
- 结构体
P：未定义json标签，序列化时会使用结构体字段名作为 JSON 字段名。 - 结构体
Person：Name和Age使用json标签映射为name和age。Address使用-标签，表示不会被序列化。Sex使用omitempty，当字段为空时不会被序列化。
1.2 序列化与反序列化
func main() {
p1 := P{
Name: "Jon",
Age: 20,
Address: "beijing",
Sex: "男",
Time: time.Now(),
}
p2 := Person{
Name: "hon",
Age: 20,
Address: "beijing",
Sex: "",
}
// 编码（序列化）
json1, err := json.Marshal(p1)
// 处理错误
fmt.Println(string(json1))
// 输出示例: {"Name":"Jon","Age":20,"Address":"beijing","Sex":"男","Time":"..."}
json2, err := json.Marshal(p2)
// 处理错误
fmt.Println(string(json2))
// 输出示例: {"name":"hon","age":20}
// 解码（反序列化）
var p3 Person
err = json.Unmarshal(json1, &p3)
// 处理错误
fmt.Printf("%+v\n", p3)
// 输出: {Name:Jon Age:20 Address: Sex:男}
err = json.Unmarshal(json2, &p3)
// 处理错误
fmt.Printf("%+v\n", p3)
// 输出: {Name:hon Age:20 Address: Sex:}
}
json.Marshal：将 Go 结构体序列化为 JSON 字符串。json.Unmarshal：将 JSON 字符串反序列化为 Go 结构体。
2. 自定义 JSON 序列化与反序列化
有时候，默认的序列化和反序列化方式无法满足需求，这时可以通过实现 MarshalJSON 和 UnmarshalJSON 方法来自定义行为。
2.1 自定义类型示例
type Massachusetts struct {
Name string
}
type P3 struct {
Name string
Address *Massachusetts
}
// 自定义 MarshalJSON 方法
func (m *Massachusetts) MarshalJSON() ([]byte, error) {
return json.Marshal(struct {
State string `json:"state"`
}{
State: m.Name,
})
}
func Customize() {
address := Massachusetts{Name: "beijing"}
p := P3{
Name: "jon",
Address: &address,
}
// 编码
jsonBytes, err := json.Marshal(p)
// 处理错误
fmt.Println(string(jsonBytes))
// 输出: {"Name":"jon","Address":{"state":"beijing"}}
}
Massachusetts结构体通过自定义MarshalJSON方法，将Name字段序列化为state字段。
3. 处理 JSON 数组
Go 中的切片（Slice）和数组（Array）可以很方便地序列化为 JSON 数组，反向亦然。
3.1 JSON 数组示例
type P4 struct {
Name string `json:"name"`
Age int `json:"age"`
}
func JsonArray() {
people := []P4{
{Name: "p1", Age: 22},
{Name: "p2", Age: 23},
}
jonsBytes, err := json.Marshal(people)
// 处理错误
fmt.Println(string(jonsBytes))
// 输出: [{"name":"p1","age":22},{"name":"p2","age":23}]
}
JsonArray函数展示了如何将切片序列化为 JSON 数组，以及如何进行反序列化。
4. 解析任意结构的 JSON 数据
在处理来自外部系统的 JSON 数据时，通常无法提前知道其具体结构。Go 提供了 map[string]interface{} 和 interface{} 来处理这种情况。
4.1 任意结构 JSON 示例
func JsonAny() {
jsonString := `{
"name":"p1",
"Age":21,
"email":"1.@qq.com"
}`
var m map[string]interface{}
err := json.Unmarshal([]byte(jsonString), &m)
// 处理错误
fmt.Printf("%+v\n", m)
// 输出: map[Age:21 email:1.@qq.com name:p1]
}
JsonAny函数展示了如何将任意结构的 JSON 字符串解析为map[string]interface{}，方便后续操作。
5. 流式处理 JSON 数据
对于大型 JSON 数据，逐行读写（流式处理）比一次性加载整个文件更加高效。Go 提供了 json.Decoder 和 json.Encoder 来处理流式 JSON 数据。
5.1 使用json.Decoder解码流式 JSON
func JsonNewDecoder() {
jsonData := `{"name":"John", "age":23}`
reader := strings.NewReader(jsonData)
decoder := json.NewDecoder(reader)
var p P4
if err := decoder.Decode(&p); err != nil {
fmt.Println(err)
}
fmt.Printf("%+v\n", p)
// 输出: {Name:John Age:23}
}
JsonNewDecoder函数展示了如何使用json.Decoder从io.Reader中逐行读取和解析 JSON 数据。
5.2 使用json.Encoder编码流式 JSON
func JsonNewEncoder() {
p := P4{Name: "p1", Age: 22}
writer := &strings.Builder{}
encoder := json.NewEncoder(writer)
if err := encoder.Encode(&p); err != nil {
fmt.Println(err)
}
fmt.Println(writer.String())
// 输出: {"name":"p1","age":22}
}
JsonNewEncoder函数展示了如何使用json.Encoder将 Go 数据结构流式写入io.Writer。
6. 时间类型的序列化与反序列化
在处理包含时间字段的 JSON 数据时，默认的序列化格式为 RFC3339。如果需要自定义时间格式，可以通过自定义类型实现。
6.1 自定义时间格式示例
type CustomTime time.Time
func (ct CustomTime) MarshalJSON() ([]byte, error) {
return []byte(fmt.Sprintf("\"%s\"", time.Time(ct).Format("2006-01-02 15:04:05"))), nil
}
func (ct *CustomTime) UnmarshalJSON(b []byte) error {
str := string(b)
str = str[1 : len(str)-1] // 去除双引号
t, err := time.Parse("2006-01-02 15:04:05", str)
if err != nil {
return err
}
*ct = CustomTime(t)
return nil
}
type P5 struct {
Name string `json:"name"`
CreatedAt CustomTime `json:"created_at"`
}
func CustomTimeExample() {
p := P5{
Name: "jon",
CreatedAt: CustomTime(time.Now()),
}
jsonBytes, err := json.Marshal(p)
// 处理错误
fmt.Println(string(jsonBytes))
// 输出: {"name":"jon","created_at":"2025-04-03 23:48:31"}
var p2 P5
err = json.Unmarshal(jsonBytes, &p2)
// 处理错误
fmt.Printf("%+v\n", p2)
// 输出: {Name:jon CreatedAt:2025-04-03 23:48:31 +0800 CST}
}
CustomTime类型通过实现自定义的MarshalJSON和UnmarshalJSON方法，定义了时间的序列化和反序列化格式。
总结
Go 语言的 encoding/json 包提供了灵活而强大的工具来处理 JSON 数据。无论是基本的序列化和反序列化，还是复杂的自定义行为、数组处理、任意结构解析以及流式处理，encoding/json 都能很好地满足需求。理解并掌握这些功能，有助于在开发中高效地处理各种 JSON 数据相关的任务。
到此这篇关于golang中encoding/json包的实现的文章就介绍到这了,更多相关golang encoding/json包内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
您可能感兴趣的文章:
相关文章
这篇文章主要介绍了go语言的sql包原理与用法,较为详细的分析了Go语言里sql包的结构、相关函数与使用方法,需要的朋友可以参考下2016-07-07
这篇文章主要介绍了GOLang IO接口与工具使用方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习吧2023-03-03
这篇文章主要介绍了golang语言中for循环语句用法,实例分析了for循环遍历的使用技巧,具有一定参考借鉴价值,需要的朋友可以参考下2015-01-01
这篇文章主要为大家介绍了golang beego框架路由ORM增删改查完整案例，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步早日升职加薪2022-04-04
本文在go web中简单的实现了中间件的机制，这样带来的好处也是显而易见的，当然社区也有一些成熟的 middleware 组件，包括 Gin 一些Web框架中也包含了 middleware 相关的功能，具体内容详情跟随小编一起看看吧2021-07-07
这篇文章主要介绍了Golang pipe在不同场景下远程交互，pipe实现从一个进程重定向至另一个进程，它是双向数据通道，用于实现进行间通信2023-03-03
本文主要介绍了golang 执行命令行的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2022-08-08
这篇文章主要介绍了关于Golang变量初始化/类型推断/短声明的问题,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2021-02-02
这篇文章主要为大家详细介绍了Go语言中的环境安装以及Get和Post请求接口的测试，文中的示例代码讲解详细，感兴趣的可以跟随小编一起学习一下2022-06-06
这篇文章主要介绍了使用腾讯云go sdk 查询对象存储中最新文件,这包括如何创建COS客户端,如何逐页检索对象列表,并如何对结果排序以找到最后更新的对象,我们还展示了如何优化用户体验,通过实时进度更新和检索多个文件来改进程序,需要的朋友可以参考下2024-03-03
最新评论