Gin 默认 encoding/json 不够用，因无法跳过空字段、不支持 int64 直接转字符串、[]byte 总 base64 编码、性能一般，且 time.Time 序列化含纳秒精度易致前端解析失败；推荐用 jsoniter 替换，需 import 替换并配置 ConfigCompatibleWithStandardLibrary，可正确处理 omitempty 和 time_format tag，ShouldBindJSON 也自动生效。
为什么 Gin 默认的 encoding/json 有时不够用
默认 JSON 编码器在字段为空时无法跳过、不支持 int64 直接转字符串、对 []byte 总是 base64 编码，且性能一般。更关键的是，它不处理 Go 的 time.Time 类型——直接序列化会变成带纳秒精度的长字符串，前端解析容易出错。如果你的 API 需要统一时间格式（如 "2024-01-01T12:00:00Z"），或要求空 slice 不输出 null 而是省略字段，就得换编码器。
用 jsoniter 替换默认编码器（推荐）
这是 Gin 官方文档明确支持的方式，无需 patch 源码，升级安全。核心是替换全局 json 包引用，并在 Gin 初始化前注册：
- 安装：
go get github.com/json-iterator/go - 在
main.go最顶部（import 块里）替换：import json "github.com/json-iterator/go" - 配置兼容标准库行为（必须）：
var json = jsoniter.ConfigCompatibleWithStandardLibrary - Gin 会自动识别并使用该
json变量，所有c.JSON()、c.ShouldBindJSON()都走新编码器
示例：定义结构体时加 omitempty 和时间格式 tag，jsoniter 能正确处理：
type User struct {
ID int64 `json:"id"`
Name string `json:"name"`
CreatedAt time.Time `json:"created_at" time_format:"2006-01-02T15:04:05Z"`
Tags []string `json:"tags,omitempty"`
}
手动控制编码过程（绕过 c.JSON）
当需要完全自定义（比如加签名、加密 payload、或混合多种序列化逻辑），就别调 c.JSON()，改用 c.Data() 手动写响应：
- 先用
jsoniter.Marshal()或自定义 encoder 得到[]byte - 显式设置
Content-Type：c.Header("Content-Type", "application/json") - 用
c.Data(http.StatusOK, "application/json", data)输出 - 注意：此时
gin.H{}、结构体等不会被自动渲染，必须自己 marshal
这种写法灵活，但丢失了 Gin 的错误包装和中间件钩子（如 logger 记录响应体长度需额外处理）。
ShouldBindJSON 也受编码器影响吗
是的，但只影响反序列化行为。Gin 的 ShouldBindJSON 底层调用的是 json.Unmarshal ——所以你替换了全局 json 包，ShouldBindJSON 就自动用 jsoniter 解析。这意味着：
- 支持更宽松的数字解析（如字符串
"123"自动转int） - 对空字段、嵌套结构体的容错性更强
- 但要注意：如果用了
jsoniter.Config{StrictMode: true}，反而会拒绝缺失字段，和默认行为相反
实际项目中，建议保持 ConfigCompatibleWithStandardLibrary，避免绑定逻辑意外变更。
