如何在Golang中写入JSON文件_Golang JSON文件写入方法汇总

P粉602998670 2025-11-17 00:00:00 次阅读

使用json.Marshal与os.WriteFile可快速写入小数据，json.Encoder适合大对象流式写入，结合MarshalIndent可格式化输出，map或slice同理处理。

在Golang中写入JSON文件是一个常见的操作，尤其是在处理配置、数据导出或API响应缓存时。Go语言通过encoding/json包提供了强大的JSON支持，结合os和io包可以轻松实现将数据写入JSON文件。以下是几种常用的写入方法汇总。

使用 json.Marshal 和 ioutil.WriteFile 写入

这是最简单直接的方式：先将Go结构体或map序列化为JSON字节流，再写入文件。

注意：Go 1.16后推荐使用os.WriteFile替代ioutil.WriteFile。

package main

import (
    "encoding/json"
    "os"
)

type Person struct {
    Name  string `json:"name"`
    Age   int    `json:"age"`
    Email string `json:"email"`
}

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

    // 序列化为JSON
    data, err := json.Marshal(person)
    if err != nil {
        panic(err)
    }

    // 写入文件，带格式缩进可使用 MarshalIndent
    err = os.WriteFile("person.json", data, 0644)
    if err != nil {
        panic(err)
    }
}

使用 json.Encoder 写入（适合大对象或流式写入）

当你需要将大量数据或多个JSON对象写入同一个文件时，json.Encoder更高效，它可以直接写入io.Writer，无需先生成完整字节切片。

package main

import (
    "encoding/json"
    "os"
)

func main() {
    file, err := os.Create("data.json")
    if err != nil {
        panic(err)
    }
    defer file.Close()

    encoder := json.NewEncoder(file)
    // 可选：美化输出
    encoder.SetIndent("", "  ")

    data := map[string]interface{}{
        "name": "Bob",
        "age":  25,
    }

    err = encoder.Encode(data)
    if err != nil {
        panic(err)
    }
}

写入格式化（带缩进）的JSON

如果你希望生成的JSON文件可读性更强，使用json.MarshalIndent代替json.Marshal。

data, err := json.MarshalIndent(person, "", "  ")
if err != nil {
    panic(err)
}
err = os.WriteFile("pretty.json", data, 0644)
if err != nil {
    panic(err)
}

第二个参数是前缀（通常为空），第三个是每个层级的缩进字符，如两个空格或\t。

处理 map 或 slice 的写入

无论是map[string]interface{}还是切片[]Person，写入方式一致。

people := []Person{
    {Name: "Alice", Age: 30},
    {Name: "Bob", Age: 25},
}

data, _ := json.MarshalIndent(people, "", "  ")
os.WriteFile("people.json", data, 0644)