Golang读写JSON数据实战教程

Go语言通过encoding/json包实现JSON的读写，首先定义带json标签的导出结构体，如User；使用json.Unmarshal将JSON字符串或文件解析到结构体；用json.Marshal或json.MarshalIndent生成格式化JSON字符串；可通过json.NewEncoder写入文件；对未知结构可用map[string]interface{}动态解析。

在Go语言中处理JSON数据非常常见，尤其是在构建Web服务、API接口或配置文件读写时。Go的标准库encoding/json提供了强大且易用的工具来序列化和反序列化JSON数据。下面通过实际例子说明如何读取（解析）和写入（生成）JSON。

定义结构体以映射JSON

要正确地读写JSON，首先要定义与JSON格式对应的Go结构体。使用结构体字段标签（struct tags）来指定JSON键名。

例如，表示一个用户信息：

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

将JSON字符串或文件解析为结构体（反序列化）

使用json.Unmarshal()可以将JSON字节流解析到结构体变量中。

示例：从JSON字符串解析数据

jsonData := `{"id": 1, "name": "Alice", "email": "alice@example.com", "active": true}`

var user User
err := json.Unmarshal([]byte(jsonData), &user)
if err != nil {
    log.Fatal("解析JSON失败:", err)
}

fmt.Printf("%+v\n", user) // 输出：{ID:1 Name:Alice Email:alice@example.com Active:true}

如果从文件读取JSON：

file, err := os.Open("user.json")
if err != nil {
    log.Fatal("打开文件失败:", err)
}
defer file.Close()

decoder := json.NewDecoder(file)
var user User
err = decoder.Decode(&user)
if err != nil {
    log.Fatal("解码JSON失败:", err)
}

将结构体转换为JSON输出（序列化）

使用json.Marshal()可以将Go结构体转换为JSON字节数组。

示例：生成JSON字符串

user := User{
    ID:     2,
    Name:   "Bob",
    Email:  "bob@example.com",
    Active: false,
}

output, err := json.Marshal(user)
if err != nil {
    log.Fatal("生成JSON失败:", err)
}

fmt.Println(string(output)) // 输出：{"id":2,"name":"Bob","email":"bob@example.com","active":false}

美化输出（带缩进）：

output, err := json.MarshalIndent(user, "", "  ")
if err != nil {
    log.Fatal("生成JSON失败:", err)
}
fmt.Println(string(output))

输出结果会格式化，便于阅读：

{
  "id": 2,
  "name": "Bob",
  "email": "bob@example.com",
  "active": false
}

写入到文件：

file, err := os.Create("output.json")
if err != nil {
    log.Fatal("创建文件失败:", err)
}
defer file.Close()

encoder := json.NewEncoder(file)
encoder.SetIndent("", "  ") // 设置缩进
err = encoder.Encode(user)
if err != nil {
    log.Fatal("写入JSON失败:", err)
}

处理动态或未知结构的JSON

当JSON结构不固定时，可以使用map[string]interface{}或interface{}来解析。

示例：

var data map[string]interface{}
err := json.Unmarshal([]byte(jsonData), &data)
if err != nil {
    log.Fatal("解析动态JSON失败:", err)
}

for k, v := range data {
    fmt.Printf("%s: %v (%T)\n", k, v, v)
}

这种方式适合处理配置、日志或第三方API返回的不确定结构。

基本上就这些。Golang的JSON处理简洁高效，结合结构体标签和标准编码解码器，能应对大多数场景。关键是结构体定义要准确，注意字段导出和标签匹配。