首页 > Golang > Go教程

Golang写入JSON数据全攻略

时间：2025-11-24 12:06:30 314浏览收藏

**Golang写入JSON文件方法全解析：轻松实现数据持久化** 在Golang中，将数据写入JSON文件是常见需求，尤其在配置管理和API数据缓存方面。本文将深入解析Golang写入JSON文件的几种常用方法，助你轻松实现数据持久化。针对小数据，可使用`json.Marshal`与`os.WriteFile`快速实现JSON序列化与文件写入；对于大型JSON对象或需要流式写入的场景，`json.Encoder`将是更高效的选择。此外，`json.MarshalIndent`方法可实现格式化输出，提升JSON文件的可读性。无论是处理Go结构体、`map`还是`slice`，本文都将提供详细的代码示例和实践指导，助你掌握Golang写入JSON文件的各种技巧，提升开发效率。

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

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

在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)

基本上就这些常用方法。选择哪种方式取决于你的场景：小数据用Marshal + WriteFile最方便；大数据或需流式处理时用json.Encoder更节省内存。同时记得处理错误，确保文件正确写入。

今天关于《Golang写入JSON数据全攻略》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！