Gin 正确序列化嵌套结构体需确保字段导出、标签规范，避免循环引用；动态过滤应使用 DTO 而非 map；中文乱码需禁用 html.EscapeHTML 或手动编码。
如何用 Gin 正确序列化嵌套结构体（父子关系）
Gin 默认使用 Go 标准库 json 包做序列化，只要结构体字段可导出（首字母大写）、有合适标签，就能自动输出嵌套 JSON。关键不是 Gin 做了什么，而是你定义的结构体是否符合 JSON 序列化规则。
常见错误：子结构体字段用小写字母开头，或漏写 json 标签，导致字段不出现或为 null。
- 父结构体字段必须是导出字段（如
Children，不能是children） - 若需自定义 key 名，用
json:"children"；若想忽略空值，加omitempty - 子结构体本身也必须满足导出 + 标签规范，否则整个嵌套层级会变成
null或空对象
示例：
type Category struct {
ID int `json:"id"`
Name string `json:"name"`
Children []Category `json:"children,omitempty"`
}
Gin 返回嵌套数据时 panic: runtime error: invalid memory address
这是典型循环引用问题——比如 Category 中的 Children 包含自身类型，而某条数据意外形成闭环（A → B → A），json.Marshal 会无限递归直至栈溢出。
立即学习“go语言免费学习笔记（深入）”；
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
实际场景中不一定是显式循环，更常见的是数据库 ORM 加载时未控制深度，把父级关联又懒加载回来。
- 检查数据构造逻辑，确保没有手动将父对象赋给子对象的
Parent字段（尤其当该字段也带json标签） - 避免在结构体里同时定义双向字段，如
Parent *Category和Children []Category共存且都参与序列化 - 临时方案：用
json:"-"忽略潜在循环字段；长期方案：用 DTO 结构体做投影，只包含需要输出的字段层级
用 c.JSON() 输出深层嵌套但部分字段需动态过滤
标准 c.JSON() 是全量序列化，没法按请求参数动态删字段。想实现“查用户时带订单，但订单里不返回商品详情”，就得提前裁剪数据，而不是靠中间件或标签控制。
- 不要试图用
map[string]interface{}拼接嵌套结构——类型丢失、易出错、无编译检查 - 推荐做法：定义明确的响应结构体（如
UserWithOrders），其Orders字段类型为精简版OrderSummary，而非完整Order - 如果层级深且组合多，可用函数工厂生成不同深度的 DTO，例如
BuildUserDTO(level int)，比运行时反射更可控
中文字段名乱码或被转义成 Unicode
Gin 的 c.JSON() 默认启用 html.EscapeHTML，会把中文转成 \u4f60\u597d。这不是 bug，是安全默认行为，但多数 API 不需要它。
- 全局关闭：在路由初始化后调用
gin.SetMode(gin.ReleaseMode)并设置router.SecureJSONPrefix("")（仅影响c.SecureJSON） - 真正有效的做法：改用
c.Render(http.StatusOK, gin.H{"data": obj})配合自定义render.JSON，或直接用json.NewEncoder(c.Writer).Encode(obj) - 注意：
c.Data()+ 手动序列化时，务必设置c.Header("Content-Type", "application/json; charset=utf-8")，否则某些客户端可能解析失败
父子级 JSON 输出的复杂点不在 Gin，而在结构设计与数据构造环节。最容易被忽略的是：你以为传进去的是干净树形数据，其实 ORM 或业务逻辑悄悄塞进了隐藏引用或未清空的指针字段。
