如何在Golang中操作JSON文件

在Golang中操作JSON文件主要依赖标准库的encoding/json和os包，通过这两个包的组合可以实现JSON文件的读取解析、数据序列化写入等完整操作，适配大多数业务场景的需求。

一、读取并解析JSON文件

首先需要将JSON文件的内容读取到内存中，再使用json.Unmarshal方法将字节数据解析到对应的结构体实例中。操作前需要先定义和JSON结构匹配的结构体，结构体的字段需要添加json tag来对应JSON中的键名。

1.1 定义匹配的结构体

假设我们有一个存储用户信息的JSON文件user.json，内容如下：

{
  "name": "张三",
  "age": 25,
  "hobbies": ["读书", "跑步"],
  "address": {
    "city": "北京",
    "street": "朝阳路"
  }
}

对应的Golang结构体定义如下，注意字段首字母需要大写保证可导出，json tag中的名称和JSON中的键名一致：

type Address struct {
	City   string `json:"city"`
	Street string `json:"street"`
}

type User struct {
	Name     string   `json:"name"`
	Age      int      `json:"age"`
	Hobbies  []string `json:"hobbies"`
	Address  Address  `json:"address"`
}

1.2 读取并解析文件

完整的读取解析代码如下：

package main

import (
	"encoding/json"
	"fmt"
	"os"
)

func main() {
	// 读取JSON文件内容
	data, err := os.ReadFile("user.json")
	if err != nil {
		fmt.Printf("读取文件失败: %vn", err)
		return
	}

	// 定义解析目标结构体实例
	var user User
	// 解析JSON数据到结构体
	err = json.Unmarshal(data, &user)
	if err != nil {
		fmt.Printf("解析JSON失败: %vn", err)
		return
	}

	// 输出解析结果
	fmt.Printf("姓名: %sn", user.Name)
	fmt.Printf("年龄: %dn", user.Age)
	fmt.Printf("爱好: %vn", user.Hobbies)
	fmt.Printf("地址: %s %sn", user.Address.City, user.Address.Street)
}

二、将结构体数据写入JSON文件

如果需要将内存中的结构体数据保存到JSON文件，需要先使用json.Marshal或者json.MarshalIndent方法将结构体序列化为JSON格式的字节数据，再写入文件。

2.1 序列化并写入文件

json.Marshal会生成紧凑的JSON字符串，json.MarshalIndent可以生成带缩进格式的美观JSON，适合配置文件场景。示例代码如下：

package main

import (
	"encoding/json"
	"fmt"
	"os"
)

func main() {
	// 构造要写入的结构体数据
	user := User{
		Name:    "李四",
		Age:     30,
		Hobbies: []string{"游泳", "摄影"},
		Address: Address{
			City:   "上海",
			Street: "南京路",
		},
	}

	// 序列化为带缩进的JSON数据，第一个参数是缩进前缀，第二个是缩进字符串
	data, err := json.MarshalIndent(user, "", "  ")
	if err != nil {
		fmt.Printf("序列化失败: %vn", err)
		return
	}

	// 写入文件，0644是文件权限，表示所有者可读可写，其他用户只读
	err = os.WriteFile("new_user.json", data, 0644)
	if err != nil {
		fmt.Printf("写入文件失败: %vn", err)
		return
	}
	fmt.Println("JSON文件写入成功")
}

三、处理动态结构的JSON文件

如果JSON文件的结构不固定，或者部分字段是可选的，可以使用map[string]interface{}来接收解析结果，这种方式不需要提前定义结构体，但是取值时需要做类型断言。

package main

import (
	"encoding/json"
	"fmt"
	"os"
)

func main() {
	data, err := os.ReadFile("dynamic.json")
	if err != nil {
		fmt.Printf("读取文件失败: %vn", err)
		return
	}

	// 使用map接收动态JSON数据
	var result map[string]interface{}
	err = json.Unmarshal(data, &result)
	if err != nil {
		fmt.Printf("解析失败: %vn", err)
		return
	}

	// 遍历输出所有键值对
	for key, value := range result {
		fmt.Printf("%s: %vn", key, value)
	}
}

四、操作注意事项

• 读取文件时需要处理文件不存在、权限不足等错误，避免程序直接崩溃。
• 结构体字段的json tag需要和JSON中的键名完全匹配，包括大小写，否则解析时对应字段会取零值。
• 如果JSON中包含中文，序列化时默认会正确处理UTF-8编码，不需要额外设置，但是写入文件时确保文件编码是UTF-8，避免乱码。
• 使用map接收动态JSON时，取值做类型断言前最好先判断类型，避免类型不匹配导致panic。

GolangJSON文件操作encoding_json文件读写结构体序列化修改时间：2026-07-19 12:24:25