应优先使用 c.JSON() 返回 JSON 响应，它自动设置 Content-Type、处理编码错误并兼容特殊类型；避免手写 json.Marshal() + c.Data()，以防 Header 遗漏或错误忽略导致前端解析失败。
用 c.JSON() 返回标准 JSON 响应，别手写 json.Marshal() 再设 Header
直接调用 c.JSON() 是 Gin 最安全、最省心的方式。它自动设置 Content-Type: application/json，处理编码错误，并兼容 nil、time.Time 等类型（依赖你注册的 json.Encoder 配置）。手写 json.Marshal() + c.Data() 容易漏掉 Header 或忽略错误返回，导致前端收不到 JSON 或解析失败。
常见错误现象：curl 返回纯文本、浏览器显示下载弹窗、前端 response.json() 报 Unexpected token —— 很可能只是没设对 Content-Type。
-
c.JSON(200, map[string]interface{}{"ok": true})是推荐写法 - 状态码必须是合法 HTTP 状态码（如
201、400），传0会触发 Gin 默认的200，但语义丢失 - 如果结构体字段没加
json:tag 且首字母小写，会被忽略（Go 的导出规则）
遇到 json: unsupported type: func() 错误，检查响应数据里有没有函数或未导出字段
这个 panic 通常发生在你把带方法的 struct 实例、闭包、或含未导出字段（小写开头）的 struct 直接传给 c.JSON()。Gin 底层用 encoding/json，它不支持序列化函数、通道、map 中的非字符串 key、或未导出字段。
使用场景：比如你定义了一个 struct 并在 handler 中 new 出来，但忘了加 json: tag；或者误把 http.HandlerFunc 当作数据传了进去。
- 用
struct{ Name string `json:"name"` }替代裸 struct - 避免在响应结构中嵌入
sync.Mutex、func()、chan int等不可序列化类型 - 调试时可先用
json.Marshal(data)单独测试，看是否 panic，比在 Gin 中排查更快
需要自定义 JSON 编码行为？替换 Gin 默认的 json.Marshal，而不是重写整个响应流程
Gin 允许全局替换 JSON 序列化函数，比如你想统一格式化时间、忽略零值、或用 easyjson 提升性能。这不是“重写响应逻辑”，而是换掉底层编码器 —— 不影响 c.JSON() 的调用方式，也不破坏中间件链。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
性能影响：标准 encoding/json 反射开销大；easyjson 或 ffjson 生成静态代码，吞吐能提升 2–5 倍，但编译时间略长。
- 替换方式：
gin.JSONSerializer{Marshal: myCustomMarshal}+gin.SetMode(gin.ReleaseMode)后生效 - 不要在每个 handler 里手动
json.Marshal+c.Writer.Write()，那样绕过 Gin 的错误处理和 Content-Type 管理 - 若用了
gjson或go-json，注意它们对time.Time和interface{}的处理可能和标准库不一致
返回空 JSON（{}）或 null？别用 c.JSON(200, nil)，用 c.Status() 或显式结构体
c.JSON(200, nil) 实际返回的是 null 字符串（JSON 标准），不是空对象。很多前端库把 null 当作错误响应处理，而空对象 {} 才是“有数据但为空”的常见约定。
容易被忽略的地方：API 文档写的是 “返回空对象”，但后端写了 c.JSON(200, nil)，导致前端 res.data.name 报错而不是返回 undefined。
- 要返回
{}：用c.JSON(200, struct{}{})或c.JSON(200, map[string]any{}) - 要返回
null（极少数场景，如 PATCH 删除字段）：明确用c.JSON(200, nil)，但需文档注明 - 仅需状态码无 body：用
c.Status(204)，比c.JSON(204, nil)更规范（HTTP 204 不该有 body）
Gin 的 JSON 响应看似简单，真正踩坑的点都在数据源头（struct 定义、字段可见性、嵌套类型）和边界情况（nil、空、状态码语义）上。别急着封装通用响应函数，先确保每次 c.JSON() 传进去的东西能被 json.Marshal 安稳吃下去。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
