Go中HTTP头为http.Header(map[string][]string),请求头通过r.Header获取(Get不区分大小写,Cookie特殊处理),响应头通过resp.Header获取,Set/Add/Del用于修改,须在Write前设置。

在 Go 语言中,HTTP 请求和响应头(Header)都以 http.Header 类型存在,本质是 map[string][]string。解析 Header 的关键在于理解其结构、区分大小写不敏感的访问方式,并正确处理多值字段(如 Set-Cookie)。
获取请求 Header(服务端)
在 HTTP 处理函数中,*http.Request 的 Header 字段直接暴露所有请求头。Go 自动将原始 Header 名标准化为“首字母大写-连字符分隔”格式(如 User-Agent → User-Agent),但读取时忽略大小写。
- 用
r.Header.Get("User-Agent")获取单个值(返回第一个,或空字符串) - 用
r.Header["Accept-Encoding"]获取原始 slice(可能为空或含多个值) - 注意:
Get对Cookie特殊处理——它会合并所有Cookie头为一个字符串(用分号分隔),而r.Cookies()才返回解析后的[]*http.Cookie
获取响应 Header(客户端)
使用 http.DefaultClient.Do(req) 发起请求后,响应对象 *http.Response 的 Header 字段即为响应头。与请求头一样,支持 Get 和直接 map 访问。
-
resp.Header.Get("Content-Type")返回"application/json; charset=utf-8"这类值 -
resp.Header["Set-Cookie"]是[]string,每个元素对应一个Set-Cookie字段(浏览器需分别处理) - 注意:
resp.Header不包含状态行信息(如HTTP/1.1 200 OK),状态码通过resp.StatusCode单独获取
手动构造和修改 Header
无论是构建请求还是设置响应头,都通过 Header.Set、Header.Add、Header.Del 操作:
立即学习“go语言免费学习笔记(深入)”;
-
req.Header.Set("Authorization", "Bearer abc123"):覆盖已有同名头 -
req.Header.Add("Accept", "application/xml"):追加新值(允许重复键) -
w.Header().Set("Content-Type", "text/html; charset=utf-8"):在 HTTP handler 中设置响应头(w是http.ResponseWriter) - 修改已发出的响应头无效——必须在调用
w.Write或w.WriteHeader前完成
遍历和调试 Header
调试时可遍历全部 Header 键值对,注意键名已被标准化:
for key, values := range r.Header {
fmt.Printf("%s: %v\n", key, values)
}
输出类似:User-Agent: [curl/7.68.0]Accept: [application/json]
若需原始未标准化键名(极少见),需在底层使用 net/http/httputil.DumpRequest 或自定义 net.Conn 拦截原始字节流。










