json.marshal 返回空字符串或错误的根源是传入了不支持json序列化的类型，如函数、channel、非基础类型map键、未导出字段等；结构体字段需大写导出，通过json tag控制键名、忽略、omitempty及inline行为；time.time需自定义marshaljson，数字精度问题需用string或专用类型处理。
json.Marshal 为什么返回空字符串或错误？
常见现象是 json.Marshal 返回空字节切片或报 "json: unsupported type" 错误。根本原因不是函数写错了，而是传入的值包含 Go 不支持 JSON 序列化的类型，比如函数、channel、map 的 key 是切片或结构体、未导出字段（小写开头）等。
实操建议：
- 检查结构体字段是否都以大写字母开头 —— 小写字段不会被序列化，也不报错，容易误以为“生成成功但内容为空”
- 避免直接传指针给
json.Marshal，除非你明确需要处理 nil 指针；若结构体里有指针字段且为nil，对应 JSON 字段会是null，不是跳过 - 用
json.MarshalIndent替代json.Marshal调试时更直观，但上线别默认用，有额外分配和格式化开销 - 如果要序列化 map，确保 key 类型是 string、int、float64 等基础类型；
map[struct{X int}]*T会直接 panic
结构体字段怎么控制 JSON 键名和是否忽略？
靠 struct tag 控制，不是靠变量名或类型自动推断。不写 tag 就用字段名全小写转驼峰（Go 默认规则），但多数情况你需要显式声明。
实操建议：
- 用
json:"name"强制指定键名，比如Name string `json:"user_name"` - 用
json:"-"完全忽略字段（包括私有字段），比删掉字段更安全，因为逻辑里可能还用得上 - 用
json:"name,omitempty"表示“为空值时跳过”，注意：零值判断基于 Go 的零值（""、0、false、nil），不是 JSON 的null - 嵌套结构体字段加
json:",inline"可以把内层字段“提上来”，但要小心键名冲突，冲突时以外层为准
时间、数字、HTML 特殊字符怎么不出问题？
json.Marshal 对 time.Time 默认输出的是 Go 内部表示（类似 {...}），不是 ISO8601 字符串；对数字默认走 float64 转换，可能丢失精度；对字符串里的 、<code>& 会自动转义成 \u003c 等，防止 XSS —— 这是设计行为，不是 bug，但有时不符合预期。
实操建议：
- 让结构体字段实现
MarshalJSON()方法，自定义时间格式，例如返回[]byte(fmt.Sprintf("%q", t.Format("2006-01-02"))) - 数值精度敏感场景（如金额），别用
float64，改用string存原始字符串，或用github.com/shopspring/decimal并自己实现MarshalJSON - 如果确定前端能安全处理原始 HTML，可用
json.RawMessage包一层，或提前用bytes.ReplaceAll把\u003c换回来 —— 但必须确认上下游信任链完整 - 别依赖
json.Encoder.SetEscapeHTML(false)全局关转义，它只影响Encode，不影响Marshal，且会影响所有后续调用
性能差、内存暴涨，是不是 json.Marshal 本身的问题？
90% 的性能问题不是 json.Marshal 算法慢，而是反复分配、结构体过大、或用了低效的中间表示（比如先拼字符串再解析成 map 再 marshal）。
实操建议：
- 避免在热路径里频繁调用
json.Marshal处理大结构体；考虑预计算、缓存 JSON 字节切片（注意并发安全） - 用
json.Encoder直接写到io.Writer（如 http.ResponseWriter），比先Marshal再Write少一次内存拷贝 - 结构体字段太多且部分字段只在特定场景用，拆成多个小结构体，按需 marshal，别总用一个“全能结构体”
- 用
go tool pprof确认瓶颈真在 marshal —— 有时候是上游数据库查了 1000 条记录，marshal 只是背锅
最容易被忽略的是：struct tag 里的空格、拼写错误（比如 json"omitempty" 少了冒号）不会报错，但整个 tag 失效，导致字段行为和预期完全相反。调试时别只盯代码逻辑，先 fmt.Printf("%#v", yourStruct) 看实际反射出来的 tag 值。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
