Go语言基于标准库encoding/json进行json文件处理详解

更新时间：2025年10月31日 09:12:49 作者：数据知道

Go语言提供了强大的内置支持来处理JSON数据,主要通过标准库encoding/json实现,下面小编就和大家详细介绍一下使用encoding/json操作Json文件的具体实现方法吧

一、JSON序列化与反序列化

Go语言提供了强大的内置支持来处理JSON数据，主要通过标准库encoding/json实现。encoding/json 库的核心作用是实现 JSON数据 与 Go语言数据结构 之间的相互转换，主要依赖两个核心函数。

功能方向	核心函数	作用
序列化	json.Marshal(v interface{}) ([]byte, error)	将Go数据结构（如结构体、切片）转换为JSON格式的字节切片
反序列化	json.Unmarshal(data []byte, v interface{}) error	将JSON格式的字节切片转换为指定的Go数据结构

1.1 序列化（将Go结构体转换为JSON）

使用json.Marshal函数可以将Go结构体转换为JSON格式的字节切片。这是最常用的场景，需注意结构体字段必须为 首字母大写（导出字段），否则无法被库识别。案例代码如下：

package main
import (
	"encoding/json"
	"fmt"
)
type Person struct {
	Name string `json:"name"`
	Age  int    `json:"age"`
}
func main() {
	person := Person{Name: "Alice", Age: 30}
	jsonData, err := json.Marshal(person)
	if err != nil {
		fmt.Println("Error marshaling JSON:", err)
		return
	}
	fmt.Println(string(jsonData))
}

输出：

{"name":"Alice","age":30}

1.2 反序列化（将JSON转换为Go结构体）

使用json.Unmarshal函数可以将JSON数据解析为Go结构体。

示例代码：

package main
import (
	"encoding/json"
	"fmt"
)
type Person struct {
	Name string `json:"name"`
	Age  int    `json:"age"`
}
func main() {
	jsonData := `{"name":"Bob","age":25}`
	var person Person
	err := json.Unmarshal([]byte(jsonData), &person)
	if err != nil {
		fmt.Println("Error unmarshaling JSON:", err)
		return
	}
	fmt.Printf("Name: %s, Age: %d\n", person.Name, person.Age)
}

输出：

Name: Bob, Age: 25

二、JSON文件读写

2.1 写入JSON文件

使用os.Create和json.Marshal结合，可以将Go结构体数据写入JSON文件。示例代码：

package main
import (
	"encoding/json"
	"os"
)
type Person struct {
	Name string `json:"name"`
	Age  int    `json:"age"`
}
func main() {
	person := Person{Name: "Charlie", Age: 28}
	file, err := os.Create("person.json")
	if err != nil {
		panic(err)
	}
	defer file.Close()
	encoder := json.NewEncoder(file)
	err = encoder.Encode(person)
	if err != nil {
		panic(err)
	}
}

运行后，person.json文件内容为：

{"name":"Charlie","age":28}

2.2 读取JSON文件

使用os.Open和json.Decoder结合，可以从JSON文件中读取数据并解析为Go结构体。示例代码：

package main
import (
	"encoding/json"
	"fmt"
	"os"
)
type Person struct {
	Name string `json:"name"`
	Age  int    `json:"age"`
}
func main() {
	file, err := os.Open("person.json")
	if err != nil {
		panic(err)
	}
	defer file.Close()
	var person Person
	decoder := json.NewDecoder(file)
	err = decoder.Decode(&person)
	if err != nil {
		panic(err)
	}
	fmt.Printf("Name: %s, Age: %d\n", person.Name, person.Age)
}

输出：

Name: Charlie, Age: 28

三、JSON处理中的常见技巧

3.1 处理嵌套JSON

Go语言支持嵌套结构体，可以轻松处理复杂的JSON数据。示例代码：

package main
import (
	"encoding/json"
	"fmt"
)
type Address struct {
	City  string `json:"city"`
	State string `json:"state"`
}
type Person struct {
	Name    string  `json:"name"`
	Age     int     `json:"age"`
	Address Address `json:"address"`
}
func main() {
	jsonData := `{"name":"David","age":40,"address":{"city":"New York","state":"NY"}}`
	var person Person
	err := json.Unmarshal([]byte(jsonData), &person)
	if err != nil {
		fmt.Println("Error unmarshaling JSON:", err)
		return
	}
	fmt.Printf("Name: %s, City: %s\n", person.Name, person.Address.City)
}

输出：

Name: David, City: New York

3.2 忽略空字段

通过omitempty标签，可以在序列化时忽略空字段。示例代码：

package main
import (
	"encoding/json"
	"fmt"
)
type Person struct {
	Name string `json:"name"`
	Age  int    `json:"age,omitempty"`
}
func main() {
	person := Person{Name: "Eve"}
	jsonData, err := json.Marshal(person)
	if err != nil {
		fmt.Println("Error marshaling JSON:", err)
		return
	}
	fmt.Println(string(jsonData))
}

输出：

{"name":"Eve"}

Go语言通过encoding/json包提供了强大的JSON处理能力，包括序列化、反序列化、文件读写及复杂数据结构的处理。

到此这篇关于Go语言基于标准库encoding/json进行json文件处理详解的文章就介绍到这了,更多相关Go处理json文件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Go
json

浅析Go语言中数组的使用
数组用于在单个变量中存储相同类型的多个值,而不是为每个值声明单独的变量,这篇文章主要为大家介绍了Go语言中数组的简单使用,需要的可以参考下
2023-08-08
通过Go channel批量读取数据的示例详解
批量处理的主要逻辑是：从 channel 中接收数据,积累到一定数量或者达到时间限制后,将数据批量处理（例如发送到 Kafka 或者写入网络）,下面我将展示一个从 Go channel 中批量读取数据,并批量发送到 Kafka 和批量写入网络数据的示例,需要的朋友可以参考下
2024-10-10
Golang实现按行读取文件的方法小结
按行读取文件相较于一次性载入,有着很多优势,如内存效率高、处理速度快、实时性高等,本文主要介绍了Golang按行读取文件的相关方法,希望对大家有所帮助
2024-02-02
golang监听文件变化的实例
这篇文章主要介绍了golang监听文件变化的实例，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2021-03-03
go语言的变量定义示例详解
这篇文章主要为大家介绍了go语言的变量定义示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-12-12
Golang 编写Tcp服务器的解决方案
Golang 作为广泛用于服务端和云计算领域的编程语言，tcp socket 是其中至关重要的功能，这篇文章给大家介绍Golang 开发 Tcp 服务器及拆包粘包、优雅关闭的解决方案，感兴趣的朋友一起看看吧
2022-10-10
Go语言中未知异常捕获的多种场景与实用技巧
在Go语言编程中,异常处理是确保程序健壮性的关键环节,与一些其他编程语言不同,Go没有传统的try - catch结构化异常处理机制,本文将深入探讨Go语言中未知异常捕获的多种场景与实用技巧,需要的朋友可以参考下
2024-11-11
Go语言中使用 buffered channel 实现线程安全的 pool
这篇文章主要介绍了Go语言中使用 buffered channel 实现线程安全的 pool,因为Go语言自带的sync.Pool并不是很好用,所以自己实现了一线程安全的 pool,需要的朋友可以参考下
2014-10-10
Go语言接口 + 结构体模式实战指南
本文详细介绍了Go语言中的“接口+结构体”模式,从基础概念、核心用法、简化场景到企业级实践,通过实际代码示例讲解了如何实现松耦合、可维护的代码结构,感兴趣的朋友跟随小编一起看看吧
2025-12-12
Golang开发Go依赖管理工具dep安装验证实现过程
这篇文章主要为大家介绍了Golang开发Go依赖管理工具dep安装验证及初始化一系列实现过程，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步
2021-11-11