首选ctx.request.header.get或ctx.getheader，二者等价且安全：大小写不敏感、返回首个值、不存在时为空字符串；禁用ctx.request.header["x-key"]下标访问，易panic。
直接用 ctx.Request.Header.Get 或 ctx.GetHeader，二者完全等价，选一个写清楚就行；别用 ctx.Request.Header["X-Key"] 下标访问，容易 panic。
为什么 ctx.Request.Header.Get 是首选
它来自 Go 标准库 http.Request.Header.Get，大小写不敏感（"content-type" 和 "Content-Type" 都能取到），自动返回第一个值，不存在时返回空字符串 —— 安全、简洁、无副作用。
- 常见错误是写成
ctx.Request.Header["X-User-ID"]：这返回[]string，如果 header 不存在会 panic，存在多个值时还得手动取[0] -
ctx.GetHeader只是它的别名，不是 Gin 特有逻辑，不要以为它支持合并、解码或通配符 - 它不处理 URL 编码，比如
User-Agent里的%20还是原样，不用额外url.QueryUnescape
ShouldBindHeader 适合结构体批量绑定
当你有一组语义明确的 header 字段（如 X-Request-ID、X-User-Roles、X-Tenant），且想统一校验/默认值时，用 ShouldBindHeader 更清晰。
- 结构体字段需加
headertag，例如Name string `header:"X-User-Name"` - 它底层仍调用
ctx.Request.Header.Get，但支持binding:"required"、default:"guest"等规则 - 不推荐为单个字段滥用此方法——增加冗余类型定义，反而不如一行
ctx.GetHeader("X-Trace-ID")直观
遍历所有 header 用 ctx.Request.Header 原生 map
调试、审计、代理透传场景下需要看全量 header，直接遍历 ctx.Request.Header 即可，它是 map[string][]string 类型。
- key 是规范化后的名称（
Accept、X-Forwarded-For），不是原始大小写 - value 是切片，同一个 header 多次出现时全部保留，比如
Roles: admin和Roles: super会同时在ctx.Request.Header["Roles"]里 - 注意：中间件里用
c.Set塞进 context 的“虚拟 header”不会出现在这里，它只反映原始 HTTP 请求头
最易被忽略的一点：Gin 不会自动解析重复 header 的语义（比如 Cookie 多个值要分号拼接、Set-Cookie 必须逐个响应），Get 返回第一个只是行为约定，不代表标准做法 —— 如果业务真依赖多值 header 的完整语义，得自己遍历 ctx.Request.Header[key] 并按协议处理。
