Go中json.Marshal序列化失败的根本原因是字段未导出或标签使用不当；它依赖反射遍历导出字段，但仅处理首字母大写的字段，零值默认省略，私有字段需通过自定义MarshalJSON方法安全访问。
Go 里没有泛型反射的自动序列化魔法，reflect 本身不处理 JSON 格式，真正起作用的是 json.Marshal 对结构体字段的反射遍历 —— 所以“通用结构体序列化”的核心不是手写反射逻辑，而是正确导出字段 + 控制标签 + 理解零值行为。
为什么直接 json.Marshal 有时返回空对象或 null？
根本原因是字段未导出（首字母小写）或缺少必要标签。Go 的 json 包只序列化导出字段（即首字母大写的字段），且默认忽略零值字段（如空字符串、0、nil 指针等）。
- 结构体字段必须首字母大写，否则
json.Marshal完全看不到它 - 如果字段是私有（小写）但你又想序列化，得用自定义
MarshalJSON方法，不能靠reflect强行绕过导出规则 -
json:"-"标签会跳过该字段；json:",omitempty"会在值为零值时省略（注意：指针类型判零是看是否为nil，不是看它指向的值）
json.Marshal 底层怎么用 reflect？你不需要重写它
标准库的 json.Marshal 内部确实大量使用 reflect（比如 reflect.Value.Kind()、reflect.Value.Field()），但它已封装好所有边界逻辑：嵌套结构、指针解引用、接口类型分发、循环引用检测（会报错）、时间格式处理等。手动用 reflect 实现等价逻辑极易出错，且无法复用 json.Encoder 流式能力。
- 别写“用 reflect 遍历 struct 再拼 JSON 字符串” —— 这既慢又不兼容标准行为（比如不处理
time.Time） - 需要动态控制字段行为？优先用 struct tag：
json:"user_id,string"表示把整数转成字符串输出 - 需要运行时决定哪些字段参与序列化？考虑用
map[string]interface{}中转，或实现MarshalJSON()方法按需构造[]byte
如何安全地序列化含非导出字段或特殊逻辑的结构体？
唯一合规方式是为结构体实现 MarshalJSON() 方法。这时你可自由使用 reflect 获取私有字段值，但必须手动构造合法 JSON 字节流 —— 注意避免注入、保证引号/转义正确、处理嵌套结构的递归调用。
立即学习“go语言免费学习笔记（深入）”；
func (u User) MarshalJSON() ([]byte, error) {
type Alias User // 防止无限递归
return json.Marshal(struct {
*Alias
FullName string `json:"full_name"`
}{
Alias: (*Alias)(&u),
FullName: u.firstName + " " + u.lastName, // 访问私有字段
})
}
- 用
type Alias匿名嵌入是常见技巧，避免在MarshalJSON里直接调json.Marshal(u)导致死循环 - 不要在
MarshalJSON里手动拼接字符串（如"{\"name\":\""+u.Name+"\"}"），易出错且不处理特殊字符 - 若字段类型不支持标准 JSON（如
net.IP、自定义错误），应在该方法内先转成基础类型（string或map）再交由json.Marshal
真正难的不是“怎么用 reflect”，而是理解 Go 的导出规则、JSON 零值语义、以及何时该让步给标准库 —— 大多数所谓“通用序列化需求”，其实只是没写对 struct tag 或误信了“反射万能论”。
