登录
首页 >  Golang >  Go教程

Golang如何写入JSON文件详解

时间：2026-05-01 16:04:37 345浏览 收藏

本文深入解析了Go语言中写入JSON文件的三种核心方法：使用json.Marshal配合os.WriteFile适用于小数据量的简洁写入，json.Encoder则专为大对象或流式场景设计，内存高效且支持连续编码，而json.MarshalIndent可一键生成格式化、易读的缩进JSON。无论处理结构体、map还是slice，这些方法均通用可靠，结合错误处理与权限设置（如0644），能稳健满足配置保存、数据导出和API缓存等实际开发需求——掌握它们，让你的Go JSON操作既高效又优雅。

如何在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学习网公众号了解相关技术文章。

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>