直接用req.Header.Get("X-API-Version")读取，注意Key需规范化为首字母大写、返回值为空字符串而非nil，须判空；应通过中间件统一解析并存入context，再用白名单map精确匹配版本字符串，避免用strconv.ParseFloat或前缀匹配。
Go HTTP Handler里怎么读取Header里的X-API-Version
直接从*http.Request的Header.Get()方法取值就行，但要注意大小写不敏感和空值处理。Go 的net/http底层会把 Header Key 自动规范化为首字母大写的格式（比如x-api-version会被转成X-Api-Version），所以用req.Header.Get("X-API-Version")是安全的。
常见错误现象：req.Header.Get("x-api-version")也能工作，但依赖实现细节，不推荐；更危险的是没做空值判断，导致后续解析 panic。
- 始终用规范化的 Key 名：用
"X-API-Version"，别用小写或下划线变体 - 必须检查返回值是否为空：
if version := req.Header.Get("X-API-Version"); version != "" { ... } - 如果 Header 不存在，
Get()返回空字符串，不是nil，别用== nil判空
如何用gorilla/mux或net/http做版本路由分发
别在每个 handler 里重复解析版本号，应该统一前置拦截。用中间件（middleware）或自定义http.Handler包装是最干净的做法，避免业务逻辑和版本控制耦合。
使用场景：你有一组 v1 和 v2 的用户接口，路径都是/api/users，但行为不同；靠 Header 区分，不是 URL 路径。
立即学习“go语言免费学习笔记（深入）”；
- 中间件中解析
X-API-Version，存到context.Context里：ctx = context.WithValue(req.Context(), keyVersion, version) - 下游 handler 用
req.Context().Value(keyVersion)取，别再读 Header - 如果用
gorilla/mux，别试图用Router.HandleFunc按 Header 匹配——它不支持 Header 条件路由 - 性能影响极小，一次字符串读取+一次 context 传递，无内存分配压力
strconv.ParseFloat和strings.HasPrefix哪个更适合版本号比较
都不适合直接用于 API 版本号比较。版本号不是纯数字，v1.2.3、2024-05、alpha 都可能出现。硬解析成 float 或做前缀匹配，会漏掉语义、出错且难维护。
正确做法是定义明确的版本标识集合，用字符串精确匹配 + 映射到具体 handler。
- 定义白名单：
map[string]http.Handler{"v1": v1Handler, "v2": v2Handler} - 用
strings.TrimSpace()清理 Header 值，防止空格干扰匹配 - 区分大小写？建议统一转小写再查 map，避免
"V1"和"v1"被当成两个版本 - 不要用
strconv.ParseFloat解析"1.2"来比大小——v1.10会小于v1.2，这是语义错误
为什么Accept头比X-API-Version更难调试
因为Accept头本身是为内容协商设计的，格式复杂（带q=权重、charset、version=参数等），而客户端 SDK 往往默认不设或设错。实际项目中，X-API-Version更可控、更易测试。
兼容性影响：浏览器发请求几乎从不带Accept: application/json;version=v2，但 Postman 或 curl 可以。如果你的 API 主要被 App 或内部服务调用，Header 方案没问题；如果暴露给大量第三方，得留好降级路径。
- 调试时用
curl -H "X-API-Version: v2" http://localhost:8080/api/users最直观 - 如果坚持用
Accept，必须用http.CanonicalHeaderKey("Accept")确保键名一致，再手动 parse 参数 - 容易踩的坑：用
req.Header.Get("Accept")拿到完整字符串后，正则匹配version=([^;]+)，但没处理q=0.8优先级，导致匹配错乱
版本控制真正的难点不在读 Header，而在 handler 分离后的共享逻辑复用——比如 v1 和 v2 都要校验 token，但 v2 多一个字段校验。这时候别复制粘贴，把公共部分抽成独立函数，版本分支只负责差异逻辑。
