如何在Golang中操作JSON文件_Golang JSON文件操作实践_技术教程

答案：Go通过encoding/json包实现JSON读写。定义结构体并用json标签映射字段，使用json.MarshalIndent序列化对象到文件，os.WriteFile写入；读取时os.ReadFile加载数据，json.Unmarshal解析到结构体指针；动态JSON可用map[string]interface{}处理，需类型断言访问值。注意字段导出、标签格式与错误处理。

在Golang中操作JSON文件是一个常见的需求，尤其是在处理配置文件、API数据交换或前后端通信时。Go语言标准库中的 encoding/json 包提供了强大且简洁的工具来序列化和反序列化JSON数据。下面通过实际示例展示如何读取、写入和操作JSON文件。

定义结构体以映射JSON数据

在处理JSON之前，通常需要定义一个Go结构体来匹配JSON的结构。使用结构体字段标签（struct tags）可以指定JSON字段名。

type Person struct {
    Name    string `json:"name"`
    Age     int    `json:"age"`
    Email   string `json:"email,omitempty"`
    Active  bool   `json:"active"`
}

其中 json:"name" 表示该字段对应JSON中的 "name" 键，omitempty 表示如果该字段为空（如零值），则在序列化时忽略它。

将数据写入JSON文件

使用 json.Marshal() 将结构体编码为JSON，并通过 os.WriteFile() 写入文件。

func writeJSON() error {
    person := Person{
        Name:   "Alice",
        Age:    30,
        Email:  "alice@example.com",
        Active: true,
    }

    data, err := json.MarshalIndent(person, "", "  ")
    if err != nil {
        return err
    }

    return os.WriteFile("data.json", data, 0644)
}

json.MarshalIndent 可以生成格式化良好的JSON，便于阅读。第二个参数是前缀，第三个是每个层级的缩进字符。

从JSON文件读取数据

使用 os.ReadFile() 读取文件内容，再用 json.Unmarshal() 解码到结构体中。

func readJSON() error {
    data, err := os.ReadFile("data.json")
    if err != nil {
        return err
    }

    var person Person
    err = json.Unmarshal(data, &person)
    if err != nil {
        return err
    }

    fmt.Printf("Name: %s, Age: %d, Email: %s, Active: %t\n",
        person.Name, person.Age, person.Email, person.Active)
    return nil
}

注意：Unmarshal 需要传入结构体指针，否则无法修改原始变量。

处理未知结构或动态JSON

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

func readDynamicJSON() error {
    data, err := os.ReadFile("data.json")
    if err != nil {
        return err
    }

    var raw map[string]interface{}
    err = json.Unmarshal(data, &raw)
    if err != nil {
        return err
    }

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

这种方式适合处理结构不固定的数据，比如第三方API返回的内容。访问嵌套字段时需进行类型断言，例如 v.(string)。

基本上就这些。Golang对JSON的支持非常成熟，结合结构体标签和标准库函数，能高效完成大多数JSON文件操作任务。只要注意字段导出（首字母大写）、标签书写和错误处理，就能避免常见问题。不复杂但容易忽略细节。