go结构体字段必须首字母大写（即导出字段）才能被encoding/json包正确序列化；小写字段默认不可见，导致json.marshal返回空对象{}。本文详解结构体与json互转的规范写法、标签控制、错误处理及最佳实践。
go结构体字段必须首字母大写（即导出字段）才能被encoding/json包正确序列化；小写字段默认不可见，导致json.marshal返回空对象{}。本文详解结构体与json互转的规范写法、标签控制、错误处理及最佳实践。
在Go语言中，将结构体（struct）安全、可靠地转换为JSON字符串，是Web API开发、微服务通信和前后端数据交互的基础能力。但初学者常遇到json.Marshal返回空对象{}的问题——如题中Sim结构体所有字段均以小写字母开头（yr, ag, withdrawal等），导致序列化结果为{}。根本原因在于：Go的encoding/json包仅能访问并序列化导出（exported）字段，即首字母大写的字段。小写字段属于包级私有，json包无法反射读取，故静默忽略。
✅ 正确结构体定义：首字母大写 + JSON标签
type Sim struct {
Yr []int `json:"yr"`
Ag []int `json:"ag"`
Av []int `json:"av"`
Db []int `json:"db"`
Wd []int `json:"wd"`
St []int `json:"st"`
Withdrawal []string `json:"withdrawal"`
}? 关键点：
- 所有字段名首字母必须大写（Yr, Withdrawal）；
- 通过反引号内的json:"xxx"标签指定JSON输出的键名（小写键名仍可保留）；
- 若省略标签（如Yr []int），则默认使用字段名Yr作为JSON键（即大写），通常不符合RESTful API命名惯例，故强烈建议显式声明小写标签。
✅ 完整可运行示例（含错误处理）
package main
import (
"encoding/json"
"fmt"
"log"
)
type Sim struct {
Yr []int `json:"yr"`
Ag []int `json:"ag"`
Av []int `json:"av"`
Db []int `json:"db"`
Wd []int `json:"wd"`
St []int `json:"st"`
Withdrawal []string `json:"withdrawal"`
}
func main() {
// 构造测试数据
s := Sim{
Yr: []int{2020, 2021, 2022},
Ag: []int{60, 61, 62},
Withdrawal: []string{"$1,200", "$1,250", "$1,300"},
}
// ✅ 序列化：Struct → JSON
data, err := json.Marshal(s)
if err != nil {
log.Fatalf("JSON marshaling failed: %v", err) // 不要忽略err！
}
fmt.Printf("JSON output:\n%s\n", string(data))
// 输出: {"yr":[2020,2021,2022],"ag":[60,61,62],"av":null,"db":null,"wd":null,"st":null,"withdrawal":["$1,200","$1,250","$1,300"]}
// ✅ 反序列化：JSON → Struct（验证双向一致性）
var decoded Sim
err = json.Unmarshal(data, &decoded)
if err != nil {
log.Fatalf("JSON unmarshaling failed: %v", err)
}
fmt.Printf("Decoded struct: %+v\n", decoded)
}⚠️ 必须注意的三大陷阱与规避策略
❌ 忽略错误检查（最危险！）
json.Unmarshal 默认静默失败，仅返回error。若不检查，解析失败时字段将保持零值（如[]int为nil、string为空），极易引发后续panic或逻辑错误。
✅ 强制实践：所有json.Marshal/json.Unmarshal调用后必须if err != nil处理，生产环境建议配合log或自定义错误包装。❌ 使用非指针调用Unmarshal
json.Unmarshal需要接收指向结构体变量的指针（&s），否则无法修改原结构体内容。传值会导致解析结果丢失。
✅ 记住口诀：“Marshal传值，Unmarshal传址”。-
❌ 字段类型不匹配或嵌套解析失败
例如JSON中"yr": "2020"（字符串）但结构体定义为Yr []int，会导致Unmarshal失败。复杂场景建议：- 使用json.Valid()预检JSON合法性；
- 启用json.Decoder.DisallowUnknownFields()拒绝未知字段；
- 对关键字段使用指针类型（如*string）并手动校验非空。
? 进阶技巧：灵活控制序列化行为
-
忽略空字段：添加,omitempty标签
Av []int `json:"av,omitempty"` // Av为nil或空切片时不输出该键
-
始终忽略某字段：添加,-标签
InternalID int `json:"-"` // 完全不参与JSON序列化
- 支持多种输入格式（如字符串数字）：实现UnmarshalJSON方法（需自定义类型）。
掌握这些规范与细节，即可在Go项目中稳健实现结构体与JSON的双向转换，避免90%以上的常见序列化问题。记住核心原则：导出字段是前提，显式标签是规范，错误检查是底线。
