json.marshal返回空对象或panic的根本原因是字段未导出、含func/chan、循环引用等；必须确保字段首字母大写、排除不支持类型、用struct tag控制键名，并为time.time等类型显式实现marshaljson。
json.Marshal 能直接序列化大多数 Go 值，但**不能处理未导出字段、循环引用、函数、channel、complex 类型，且默认不忽略零值字段**——这是你写完代码却得到冗余字段或 panic 的根本原因。
为什么 json.Marshal 返回空或 panic？
常见错误不是语法错，而是类型或结构问题：
-
struct字段首字母小写（如name string）→ 序列化后该字段消失，返回{}或缺失键 - 传入
nil指针或未初始化的map/slice→json.Marshal不报错但输出null，容易被误认为“没数据” - 结构体含
time.Time字段且无自定义MarshalJSON方法 → 默认转成空对象{}或 panic（取决于 Go 版本和 time layout） - 字段类型是
func()、chan int、complex64→ 直接返回error: json: unsupported type
json.Marshal 和 json.MarshalIndent 怎么选？
二者核心逻辑完全一致，差异仅在输出格式：
-
json.Marshal输出紧凑 JSON（无空格换行），适合网络传输、日志存储 -
json.MarshalIndent多两个参数：prefix（每行前缀）和indent（缩进符），例如json.MarshalIndent(v, "", " ")生成可读性高的格式，仅用于调试或配置文件生成 - 性能上
MarshalIndent略慢（需额外字符串拼接），线上服务避免在高频路径使用
如何控制字段是否出现在 JSON 中？靠 struct tag，不是 if 判断
字段级行为由 struct tag 决定，硬编码逻辑既啰嗦又易错：
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
-
json:"-"→ 该字段永远不参与序列化（如密码、临时缓存） -
json:"name,omitempty"→ 仅当值为对应类型的零值（""、0、nil）时跳过，注意：omitempty对指针字段有效，但对非空指针指向零值（如*int指向0）仍会输出"name": 0 -
json:"name,string"→ 强制将数值字段（int、bool）转成 JSON 字符串，常用于 API 兼容（如前端期望"count": "5"）
示例：
type User struct {
ID int `json:"id"`
Name string `json:"name,omitempty"`
Token *string `json:"token,omitempty"` // nil 时不出现；非 nil 时无论内容都出现
Raw []byte `json:"raw,omitempty"` // []byte 零值是 nil，所以 omitempty 有效
}
嵌套结构体或 map 里字段名对不上？检查 tag 作用域和 key 类型
JSON 键名不匹配，90% 是 tag 没写对或 map key 不是 string：
- 嵌入结构体（anonymous struct）字段若未加 tag，默认用原字段名；加了 tag 才按 tag 生效
-
map序列化要求 key 必须是string，否则json.Marshal直接返回 error；map[interface{}]interface{}中非 string key 会被静默忽略 - 如果 map key 是
int，必须先转成string（如strconv.Itoa(k)）再构造新 map
典型陷阱：
data := map[int]string{1: "a", 2: "b"}
b, _ := json.Marshal(data) // b == []byte("null")，不是你想的 {"1":"a","2":"b"}
真正麻烦的从来不是怎么调用 json.Marshal，而是它沉默地“成功”了——比如字段没导出、map key 类型不对、time.Time 未处理——结果 JSON 缺字段、多 null、或前端解析失败。每次序列化前，花三秒确认：字段是否导出？tag 是否写对？值是否可能为 nil？map key 是 string 吗？golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
