在Gin中需统一API响应格式，定义含Code、Message、Data、Timestamp字段的Response结构体，封装Success/Fail等响应函数，并在Handler中正确调用，禁止defer中响应或重复c.JSON。
在Gin框架中实现API响应格式统一，需避免每个接口手动写c.JSON(200, gin.H{...})导致字段不一致、易漏状态码、重复逻辑和敏感信息泄露，同时防止多次调用c.JSON引发panic。
定义统一响应结构体
新建response.go文件，声明Response结构体，字段名与JSON key严格对应，禁止嵌套过深或复用数据库模型。
Code必须为int类型，约定0表示成功，非0为业务错误码；Message用string而非*string，空字符串比nil更安全；Data声明为any（Go 1.18）或interface{}，但实际传入时优先用具体结构体指针或map[string]any；Timestamp用int64存储time.Now().UnixMilli()，避免Format字符串化带来的GC压力。
结构体tag中禁用`,string`等强制类型转换，尤其不要对数字字段加该tag——否则前端解析失败。
【Code字段必须是int，不可用string；Data字段不能为空接口裸传，如直接传func()会导致运行时panic】
封装Success/Fail响应函数
方法一：基础封装，显式传参
在response.go中添加Success函数，固定返回HTTP 200状态码，Code=0，Message="success"，Data按需传入，Timestamp自动注入。
Fail函数接收code（业务码）、msg（前端可见提示）、status（HTTP状态码，默认500），内部调用c.AbortWithStatusJSON确保响应链终止，防止后续代码执行。
方法二：带默认消息的快捷封装
新增Ok(c *gin.Context, data any)和Fail400(c *gin.Context, msg string)等函数，减少重复字符串字面量，提升可读性。例如Fail400自动设Code=400、HTTP状态码=400、Message=msg。
所有响应函数末尾必须加return，否则handler后续语句仍会执行，可能造成重复写响应或panic。
在Handler中正确调用响应函数
第一步：导入response包，确保路径正确，避免循环引用。
第二步：删除原c.JSON(200, gin.H{...})写法，改用response.Success(c, user)或response.Fail400(c, "用户名不能为空")。
第三步：参数校验失败时，立即调用Fail400并return；查询DB返回sql.ErrNoRows时，不能透传错误原文，须转为"用户不存在"等语义明确提示。
注意：严禁在defer里调用任何响应函数——defer在函数退出时执行，此时响应头已写入，再调用c.JSON会触发write on flushed body panic。
第四步：若使用Gin Recovery中间件捕获panic，确保它只处理未被捕获的panic，不干扰你主动调用的Fail系列函数。
