问题现象：json.Marshal返回空对象但无错误
许多go语言开发者在尝试将结构体实例序列化为json字符串时，会遇到一个令人费解的现象：尽管结构体中包含了完整的数据，并且json.marshal函数返回的err值为nil，但最终得到的json字符串却是一个空的{}。以下是一个典型的错误示例：
package main
import (
"encoding/json"
"fmt"
)
type Address struct {
street string // 小写字母开头，字段不可导出
extended string
city string
state string
zip string
}
type Name struct {
first string // 小写字母开头，字段不可导出
middle string
last string
}
type Person struct {
name Name // 嵌套结构体字段，小写字母开头，不可导出
age int // 小写字母开头，字段不可导出
address Address
phone string
}
func main() {
myname := Name{"Alfred", "H", "Eigenface"}
myaddr := Address{"42 Place Rd", "Unit 2i", "Placeton", "ST", "00921"}
me := Person{myname, 24, myaddr, "000 555-0001"}
b, err := json.Marshal(me)
if err != nil {
fmt.Println("序列化错误:", err)
}
fmt.Println("序列化结果:", string(b)) // 输出: 序列化结果: {}
fmt.Println("原始结构体:", me) // 输出: 原始结构体: { {Alfred H Eigenface} 24 {42 Place Rd Unit 2i Placeton ST 00921} 000 555-0001}
}从上述代码的输出可以看出，me结构体本身是包含数据的，但json.Marshal却生成了空JSON。同时，err变量为nil，表明在json.Marshal的执行过程中没有发生运行时错误。这种现象常常令人感到困惑，因为它似乎与我们的直观预期不符。
核心原理：Go语言的可见性规则与JSON序列化
Go语言有一套明确的可见性规则，用于控制包内外对标识符（如变量、函数、结构体字段等）的访问。其核心原则是：
- 可导出（Exported）：如果标识符的首字母是大写，则它在声明它的包外部是可见和可访问的。
- 不可导出（Unexported）：如果标识符的首字母是小写，则它只能在声明它的包内部访问。
encoding/json包在执行json.Marshal操作时，严格遵循Go语言的这一可见性规则。具体来说：
- 只序列化可导出字段：json.Marshal只会检查并序列化结构体中那些首字母大写的字段。
- 忽略不可导出字段：对于首字母小写的字段，json.Marshal会直接忽略它们，不会将其包含在生成的JSON输出中。
- err为nil的原因：当所有可导出的字段（如果存在的话）都被成功序列化，或者结构体中根本没有可导出字段时，json.Marshal会认为操作成功，并返回nil错误。因此，即使生成的JSON是空的，err也可能为nil。这是因为从encoding/json包的角度来看，它已经成功地处理了所有它“能看到”的字段。
解决方案：导出结构体字段
要解决json.Marshal返回空JSON的问题，只需将需要序列化为JSON的结构体字段的首字母改为大写，使其成为可导出字段。
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"encoding/json"
"fmt"
)
type Address struct {
Street string `json:"street"` // 首字母大写，可导出
Extended string `json:"extended"`
City string `json:"json_city"` // 示例：自定义JSON字段名
State string `json:"state"`
Zip string `json:"zip"`
}
type Name struct {
First string `json:"first"`
Middle string `json:"middle,omitempty"` // 示例：使用omitempty标签
Last string `json:"last"`
}
type Person struct {
Name Name `json:"name"`
Age int `json:"age"`
Address Address `json:"address"`
Phone string `json:"phone"`
}
func main() {
myname := Name{First: "Alfred", Middle: "H", Last: "Eigenface"}
myaddr := Address{Street: "42 Place Rd", Extended: "Unit 2i", City: "Placeton", State: "ST", Zip: "00921"}
me := Person{Name: myname, Age: 24, Address: myaddr, Phone: "000 555-0001"}
b, err := json.Marshal(me)
if err != nil {
fmt.Println("序列化错误:", err)
return
}
fmt.Println("序列化结果:", string(b))
// 预期输出示例:
// {"name":{"first":"Alfred","middle":"H","last":"Eigenface"},"age":24,"address":{"street":"42 Place Rd","extended":"Unit 2i","json_city":"Placeton","state":"ST","zip":"00921"},"phone":"000 555-0001"}
}在这个修正后的示例中，所有需要被序列化的字段（如Address中的Street、Name中的First、Person中的Name和Age等）都已改为大写字母开头，使其成为可导出字段。现在，json.Marshal将能够正确地识别并序列化这些字段，生成包含完整数据的JSON字符串。
注意事项与最佳实践
json标签的使用： 虽然将字段首字母大写使其可导出是必须的，但通常我们希望JSON字段名是小写或使用蛇形命名法（snake_case）。这时，可以使用结构体字段标签（json tag）来指定JSON中的字段名。 例如：Street stringjson:"street"`。这样，在Go代码中字段名仍是大写的Street，但在JSON中会显示为street`。
omitempty标签： 如果某个字段的值是其类型的零值（例如，string为空字符串""，int为0，slice为nil），并且你不希望它出现在JSON输出中，可以使用omitempty标签。 例如：Middle stringjson:"middle,omitempty"` `。
嵌套结构体： 对于嵌套的结构体字段，同样需要确保它们本身是可导出的（即Person中的Name和Address字段首字母大写），并且嵌套结构体内部的字段（如Name中的First、Address中的Street）也是可导出的，才能被正确序列化。
错误处理： 尽管本文讨论的问题中err为nil，但在实际应用中，始终应该检查json.Marshal返回的错误。例如，如果尝试序列化一个包含循环引用的结构体，Marshal函数会返回一个错误。
官方文档： 遇到encoding/json包相关问题时，查阅Go官方文档是获取最准确信息和详细说明的最佳途径。
总结
Go语言中json.Marshal返回空JSON对象{}的常见原因在于结构体字段的可见性。为了确保结构体字段能够被正确地序列化为JSON，必须将这些字段的首字母大写，使其成为可导出字段。同时，合理利用json标签可以更好地控制JSON输出的格式，使其符合API规范或前端需求。理解并遵循Go语言的导出规则是有效使用encoding/json包的关键。
