gin.Context是Gin框架为每个HTTP请求创建的专属结构体实例，封装*http.Request和http.ResponseWriter，提供参数获取、响应控制、中间件通信及响应构造等核心能力，其生命周期由框架管理且不可手动创建或全局存储。
要准确获取请求参数、设置响应头、传递中间件数据或提前终止请求流程，必须理解gin.Context对象的结构和生命周期，否则容易在Handler中读不到表单值、跨中间件取不到Key、Abort后仍继续执行后续逻辑。
Context到底是什么：不是Go原生context，而是Gin专属请求载体
gin.Context不是go标准库的context.Context，它是一个结构体实例，每个HTTP请求独享一份，由Gin框架自动创建并注入到所有注册的Handler和中间件中。
它内部封装了*http.Request和http.ResponseWriter，还自带Params（路径参数）、Keys（键值存储）、Errors（错误队列）、HandlersChain（处理器链）等字段，是贯穿整个请求生命周期的“状态容器”。
你不能自己new *gin.Context，也不该把它存成全局变量——【每个请求的Context实例互不共享，响应返回后即被sync.Pool回收】。
获取客户端数据：从URL、Header到Cookie的统一入口
方法一：直接访问Request字段（最底层，需自行解析）
用c.Request.URL.Query().Get("page")取查询参数，但注意未缓存时会重复解析；推荐优先用c.Query("page")。
方法二：使用封装好的快捷方法
c.Query("id") → 获取URL查询参数
c.DefaultQuery("limit", "10") → 无值时返回默认字符串
c.PostForm("username") → 获取POST表单值（自动解析x-www-form-urlencoded或multipart/form-data）
c.GetHeader("Authorization") → 获取请求头值
方法三：读取Cookie与JSON数据
c.Cookie("session_id") → 返回cookie值和error
c.ShouldBindJSON(&user) → 自动校验并反序列化JSON到结构体，失败自动Abort并写400响应
⚠️注意：ShouldBind系列方法会触发Abort()，后续代码不会执行，不要在ShouldBind后写业务逻辑。
控制响应流程：Abort、Next与状态码设置
第一步：用c.Abort()中断当前请求链
调用后，当前Handler及后续所有中间件/Handler都不再执行，但已写入的响应头和部分body可能已发送，务必在Write之前调用。
第二步：用c.Next()显式跳转到下一个Handler
仅在自定义中间件中需要手动控制执行顺序时使用，比如鉴权中间件验证通过后才调Next()，否则直接Abort()。
第三步：设置状态码与响应头
c.Status(401) → 仅设状态码，不写body
c.AbortWithStatus(403) → 设状态码并立即Abort
c.Header("X-Trace-ID", traceID) → 设置响应头，必须在Write前调用
c.Writer.WriteHeader(500) → 底层写法，一般不用，优先用c.Status()或c.JSON()
在中间件间传递数据：Keys与Set/Get的线程安全用法
用c.Set("user_id", 123)存数据，再用c.Get("user_id")取值，返回(value interface{}, exists bool)。
Keys字段是map[any]any类型，内部加了读写锁，支持并发安全读写。
注意：c.Keys在首次Set时才初始化，若直接访问c.Keys["xxx"]会panic，必须始终用c.Get()判断是否存在。
这一步操作起来很简单，直接c.Set("role", "admin")就行，但切记不要存指针或可变结构体——因为Context会被sync.Pool复用，残留数据可能污染下个请求。
构造响应体：JSON、HTML、文件等快速返回方式
c.JSON(200, map[string]string{"msg": "ok"}) → 自动设Content-Type为application/json并序列化
c.XML(200, struct{ Name string }{"Gin"}) → 同理，设Content-Type为application/xml
c.HTML(200, "index.tmpl", gin.H{"title": "Home"}) → 渲染模板，需先加载HTML模板引擎
c.Data(200, "image/png", imageData) → 直接写原始字节流，不设任何Header，需自行保证Content-Type正确
c.File("./logo.png") → 以attachment方式下载文件，c.FileAttachment("./logo.png", "logo.png") → 指定下载名
