Go语言中设置自定义HTTP Header必须使用http.NewRequest后调用req.Header.Set（覆盖）或Add（追加），http.Get/Post无法自定义；Host等标准头禁用Set，响应头解析需注意map[string][]string结构及Get与直接索引的区别。
Go 语言里处理自定义 HTTP Header，核心不在“框架”，而在 net/http 包原生机制——几乎所有框架（如 Gin、Echo、Fiber）都基于它封装，Header 操作逻辑一致。直接用标准库就能搞定绝大多数需求，加框架反而可能掩盖底层细节，导致踩坑。
如何正确设置请求 Header：必须用 http.NewRequest
用 http.Get 或 http.Post 无法设置自定义 Header，它们内部会新建 *http.Request 并锁定 Header；只有自己调用 http.NewRequest 才能控制 Header 字段。
-
req.Header.Set("Authorization", "Bearer xxx")：覆盖式写入，适合单值字段（如User-Agent、Content-Type） -
req.Header.Add("Cookie", "a=1")和req.Header.Add("Cookie", "b=2")：追加式写入，适合多值字段（如Cookie、Accept） - 禁止对
Host、Content-Length、Connection等字段调用Set，会被 client 自动忽略或 panic；需改用req.Host = "example.com"
解析响应 Header 时注意大小写与多值
resp.Header 是 map[string][]string 类型，键名自动规范化（如 "content-type" 和 "Content-Type" 都能通过 Get 访问），但取值行为有差异：
-
resp.Header.Get("Content-Type")：返回第一个值，忽略大小写，适合单值场景 -
resp.Header["Content-Type"]：返回完整[]string，需手动遍历，适合可能含多个值的字段（如Set-Cookie） - 某些服务返回的
WWW-Authenticate可能含空格分隔的多个 scheme，不能只靠Get提取完整字符串
在 Gin/Echo 等框架中读取请求 Header 的常见误操作
框架里获取客户端 Header 看似简单，但容易混淆来源和时机：
立即学习“go语言免费学习笔记（深入）”；
- Gin 中用
c.Request.Header.Get("X-Request-ID")是安全的，但c.GetHeader("X-Request-ID")实际也是调同一底层方法，无本质区别 - 不要在中间件里修改
c.Request.Header后再传给后续 handler——Header 是引用类型，改了会影响所有下游逻辑，且多数框架不鼓励运行时篡改原始请求头 - 若需注入 Header（如网关透传），应在反向代理层用
req.Header.Set，而非在业务 handler 中“模拟”添加
Header 处理最易被忽略的一点：它不是纯字符串映射，而是 map[string][]string。很多 bug 来自假设某个 Header 一定只有一个值，或用 = 赋值代替 Add 导致 Cookie 丢失。动手前先确认协议规范是否允许多值，再决定用 Set 还是 Add。
