go 的 `net/http` 包对 http 头部字段名采用“规范格式”（canonical header key），即首字母大写、连字符分隔的驼峰式命名（如 `content-type`），而非全大写或下划线风格；调用 `header.get()` 等方法时会自动标准化，但直接访问 `header` 映射时需手动确保键名合规。
在 Go 中处理 HTTP 请求头时，开发者常误以为需按 PHP 风格（如 HTTP_USER_AGENT）或全大写加下划线方式传入字段名。实际上，Go 的 net/http 包严格遵循 RFC 7230 对头部字段名的语义约定，并通过 规范格式化（canonicalization） 统一管理键名。
http.Header 是一个 map[string][]string，其键名默认采用 http.CanonicalHeaderKey 函数标准化：将每个单词首字母大写，其余小写，单词间以连字符 - 连接（注意不是下划线 _ 或空格）。例如：
- content-type → Content-Type
- etag → Etag（注意：Etag 是特例，非 ETag；Go 标准库沿用此历史写法）
- x-forwarded-for → X-Forwarded-For
- accept-encoding → Accept-Encoding
你无需手动调用 http.CanonicalHeaderKey——所有 Header 类型的公开方法（如 .Get(), .Set(), .Add(), .Del()）均会自动完成标准化：
// ✅ 正确：方法内部自动规范化，以下写法等效
req.Header.Get("content-type") // → 返回 Content-Type 对应值
req.Header.Get("CONTENT-TYPE") // → 同样有效
req.Header.Get("Content-Type") // → 推荐，语义清晰
// ❌ 错误：若直接访问 map 且未规范键名，可能查不到
value := req.Header["content-type"] // 可能为 nil —— 因实际 key 是 "Content-Type"因此，安全读取头信息的推荐方式始终是使用 Header.Get()：
contentType := req.Header.Get("Content-Type")
userAgent := req.Header.Get("User-Agent")
xRealIP := req.Header.Get("X-Real-IP")若需遍历所有请求头（例如用于日志或调试），可直接 range req.Header，此时返回的 name 已是规范格式：
for name, values := range req.Header {
fmt.Printf("%s: %v\n", name, values) // name 如 "Accept-Encoding", "Cookie"
}⚠️ 注意事项：
- 不要依赖大小写敏感的原始键名；Go 的 Header 映射本身不保证键的原始输入形式；
- 自定义中间件或封装工具时，若需构造新 header，建议显式调用 http.CanonicalHeaderKey("my-custom-header") 保证一致性；
- 常见标准头名可参考 IANA HTTP Header Registry，Go 的规范逻辑与其语义一致。
总之，Go 的设计哲学是“由标准库接管格式细节”，开发者只需使用语义清晰的常见写法（如 "Authorization"），即可获得健壮、跨平台兼容的 header 操作体验。
