将 Go 结构体转换为 JSON-Golang-PHP中文网

将 Go 结构体转换为 JSON

碧海醫心

发布： 2025-08-17 19:48:34

原创

774人浏览过

将 go 结构体转换为 json

本文介绍了如何使用 encoding/json 包将 Go 结构体转换为 JSON 字符串。重点解释了结构体字段必须是导出的才能被 JSON 编码器访问，并提供了一个示例代码，展示了如何正确地将结构体转换为 JSON 格式。通过本文，读者可以避免在 Go 中进行 JSON 序列化时常见的 "返回 {}" 的问题。

在 Go 语言中，将结构体转换为 JSON 字符串是一个常见的任务，通常使用 encoding/json 包的 json.Marshal() 函数来实现。然而，初学者经常会遇到一个问题：即使结构体中有数据，转换后的 JSON 字符串却是 {}。这通常是因为结构体的字段没有被正确地导出。

导出字段的重要性

在 Go 语言中，只有导出的字段（即以大写字母开头的字段）才能被包外部访问。 json.Marshal() 函数也遵循这个规则。如果结构体的字段是未导出的（以小写字母开头），那么 json.Marshal() 函数将无法访问这些字段，因此无法将它们序列化为 JSON。

示例代码

以下是一个演示这个问题的示例：

package main

import (
    "encoding/json"
    "fmt"
)

type User struct {
    name string // 未导出的字段
}

func main() {
    user := &User{name: "Frank"}
    b, err := json.Marshal(user)
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(string(b)) // 输出: {}
}

登录后复制

在这个例子中，User 结构体的 name 字段是未导出的，因此 json.Marshal() 函数无法访问它，最终输出的 JSON 字符串是 {}。

Linfo.ai

Linfo AI 是一款AI驱动的 Chrome 扩展程序，可以将网页文章、行业报告、YouTube 视频和 PDF 文档转换为结构化摘要。

查看详情

解决方案

要解决这个问题，只需将结构体的字段导出即可。将字段名首字母大写：

package main

import (
    "encoding/json"
    "fmt"
)

type User struct {
    Name string // 导出的字段
}

func main() {
    user := &User{Name: "Frank"}
    b, err := json.Marshal(user)
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(string(b)) // 输出: {"Name":"Frank"}
}

登录后复制

在这个修改后的例子中，User 结构体的 Name 字段是导出的，因此 json.Marshal() 函数可以访问它，并将其序列化为 JSON 字符串。

总结

当使用 json.Marshal() 函数将 Go 结构体转换为 JSON 字符串时，务必确保结构体的字段是导出的。这是解决 "返回 {}" 问题的关键。记住，只有以大写字母开头的字段才能被 JSON 编码器访问。

以上就是将 Go 结构体转换为 JSON的详细内容，更多请关注php中文网其它相关文章！