go结构体转json为空对象{}或反序列化后字段为零值，根本原因是字段未导出（首字母小写），encoding/json包无法通过反射访问私有字段，必须将字段名首字母大写并合理使用json标签。
go结构体转json为空对象{}或反序列化后字段为零值，根本原因是字段未导出（首字母小写），encoding/json包无法通过反射访问私有字段，必须将字段名首字母大写并合理使用json标签。
在Go语言中，encoding/json包的序列化（json.Marshal）与反序列化（json.Unmarshal）均依赖反射机制，而Go的反射规则明确规定：只有导出字段（exported fields）——即首字母大写的字段——才能被外部包（包括标准库）访问。你定义的结构体：
type Message struct {
name string // ❌ 小写开头 → 未导出 → json包完全不可见
things []string // ❌ 同样未导出
}
尽管fmt.Println(i)能正常打印结构体内容（因日志直接操作内存值），但json.Marshal(i)实际只能看到“空结构”，故返回字节[123 125]——即{}的ASCII编码；同理，json.Unmarshal也无法向未导出字段赋值，解码后o的所有字段保持零值（""、nil切片等）。
✅ 正确做法是：将字段名改为首字母大写（导出），并通过json标签精确控制JSON键名，以兼顾Go命名规范与API契约要求：
type Message struct {
Name string `json:"name"` // 导出字段 + 显式映射为小写键
Things []string `json:"things"` // 导出字段 + 显式映射为复数形式键
}
完整可运行示例（含错误处理）：
package main
import (
"encoding/json"
"fmt"
"log"
)
type Message struct {
Name string `json:"name"`
Things []string `json:"things"`
}
func main() {
i := Message{
Name: "Steel",
Things: []string{"Iron", "Carbon"},
}
fmt.Printf("Go value: %+v\n", i)
// 输出: Go value: {Name:"Steel" Things:["Iron" "Carbon"]}
// ✅ 序列化：导出字段 + 标签生效
b, err := json.Marshal(i)
if err != nil {
log.Fatal("Marshal failed:", err)
}
fmt.Printf("JSON bytes: %v\n", b)
fmt.Printf("JSON string: %s\n", string(b))
// 输出: {"name":"Steel","things":["Iron","Carbon"]}
// ✅ 反序列化：同样依赖导出字段
var o Message
if err := json.Unmarshal(b, &o); err != nil {
log.Fatal("Unmarshal failed:", err)
}
fmt.Printf("Decoded: %+v\n", o)
// 输出: Decoded: {Name:"Steel" Things:["Iron" "Carbon"]}
}
⚠️ 关键注意事项：
- 导出性优先于标签：json:"xxx"仅控制键名映射，不能绕过导出限制。即使写成name stringjson:"name"`，该字段仍被忽略。
- 类型一致性不可忽视：若JSON中"things"可能为null或缺失，建议使用指针或omitempty标签（如Things *[]stringjson:"things,omitempty"）；若涉及数字/布尔等，务必确保Go字段类型（int/bool`）与JSON值类型严格匹配。
- 嵌套结构体同理：若Things是自定义结构体切片，其内部字段也需全部导出。
- 生产环境必检错误：json.Marshal和json.Unmarshal均返回error，忽略它将掩盖类型不匹配、语法错误等深层问题。
遵循“首字母大写导出 + json标签显式声明”的双重约定，即可彻底规避JSON编解码静默失败问题，构建健壮、可维护的API数据层。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
