使用 Go 解析 JSON 文件到结构体-Golang-PHP中文网

使用 Go 解析 JSON 文件到结构体

聖光之護

发布： 2025-10-11 11:52:04

原创

679人浏览过

使用 go 解析 json 文件到结构体

本文将详细介绍如何使用 Go 语言解析 JSON 文件并将其映射到结构体中。重点讲解了结构体字段的导出对 JSON 解析的影响，并提供了可运行的代码示例，帮助开发者避免常见的解析错误，从而更有效地使用 Go 处理 JSON 数据。

Go 语言提供了强大的 encoding/json 包，可以方便地进行 JSON 数据的序列化和反序列化。然而，在将 JSON 数据解析到结构体时，需要注意一些关键点，否则可能会遇到解析失败的问题。本文将深入探讨这些问题，并提供解决方案。

结构体字段的导出

Go 语言中，只有导出的字段（即首字母大写的字段）才能被 encoding/json 包访问。这意味着，如果结构体字段未导出，JSON 解析器将无法设置这些字段的值，导致解析结果不符合预期。

例如，以下代码定义了一个结构体 settings，其中所有字段都是未导出的：

package main

import (
    "encoding/json"
    "fmt"
    "os"
)

type settings struct {
    serverMode bool
    sourceDir  string
    targetDir  string
}

func main() {
    configFile, err := os.Open("config.json")
    if err != nil {
        fmt.Println("opening config file error:", err)
        return
    }
    defer configFile.Close()

    var config settings
    jsonParser := json.NewDecoder(configFile)
    if err = jsonParser.Decode(&config); err != nil {
        fmt.Println("parsing config file error:", err)
        return
    }

    fmt.Printf("%v %s %s\n", config.serverMode, config.sourceDir, config.targetDir)
}

登录后复制

对应的 config.json 文件内容如下：

{
    "serverMode": true,
    "sourceDir": ".",
    "targetDir": "."
}

登录后复制

运行上述代码，即使 config.json 文件包含有效的数据，程序输出的结果仍然是 false，因为结构体 settings 中的字段 serverMode、sourceDir 和 targetDir 都是未导出的。

要解决这个问题，需要将结构体字段导出：

必应图像创建器

微软必应出品的AI绘图工具

593

查看详情

package main

import (
    "encoding/json"
    "fmt"
    "os"
)

type settings struct {
    ServerMode bool `json:"serverMode"`
    SourceDir  string `json:"sourceDir"`
    TargetDir  string `json:"targetDir"`
}

func main() {
    configFile, err := os.Open("config.json")
    if err != nil {
        fmt.Println("opening config file error:", err)
        return
    }
    defer configFile.Close()

    var config settings
    jsonParser := json.NewDecoder(configFile)
    if err = jsonParser.Decode(&config); err != nil {
        fmt.Println("parsing config file error:", err)
        return
    }

    fmt.Printf("%v %s %s\n", config.ServerMode, config.SourceDir, config.TargetDir)
}

登录后复制

在这个修改后的版本中，结构体字段 ServerMode、SourceDir 和 TargetDir 都是导出的。此外，我们还使用了 json:"..." tag 来指定 JSON 字段与结构体字段之间的映射关系。如果没有tag，默认使用字段名作为json的key，但是首字母需要小写。

现在，运行程序将正确地输出从 config.json 文件解析得到的值：true . .。

使用 json.Unmarshal 函数

除了使用 json.NewDecoder，还可以使用 json.Unmarshal 函数将 JSON 数据解析到结构体中。json.Unmarshal 函数接受一个 []byte 类型的 JSON 数据和一个指向结构体的指针作为参数。

package main

import (
    "encoding/json"
    "fmt"
    "os"
    "io/ioutil"
)

type settings struct {
    ServerMode bool `json:"serverMode"`
    SourceDir  string `json:"sourceDir"`
    TargetDir  string `json:"targetDir"`
}

func main() {
    configFile, err := os.Open("config.json")
    if err != nil {
        fmt.Println("opening config file error:", err)
        return
    }
    defer configFile.Close()

    byteValue, _ := ioutil.ReadAll(configFile)

    var config settings
    err = json.Unmarshal(byteValue, &config)
    if err != nil {
        fmt.Println("parsing config file error:", err)
        return
    }

    fmt.Printf("%v %s %s\n", config.ServerMode, config.SourceDir, config.TargetDir)
}

登录后复制

这段代码首先读取 config.json 文件的内容到 byteValue 变量中，然后使用 json.Unmarshal 函数将 JSON 数据解析到 config 结构体中。