本文介绍了如何使用 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 字符串是 {}。
解决方案
要解决这个问题，只需将结构体的字段导出即可。 将字段名首字母大写：
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 编码器访问。
