最常用方式是 req.URL.Query(),它自动解析并解码查询字符串,支持重复键和编码处理;Get("key") 取首值,["key"] 取所有值,需判空再转换类型,且惰性解析、线程安全。

在 Go 的 HTTP 服务中,获取 URL 查询参数最常用、最直接的方式就是通过 req.URL.Query(),它返回一个 url.Values 类型(本质是 map[string][]string),能安全处理重复键、空值和编码问题。
为什么用 req.URL.Query() 而不是手动解析?
req.URL.Query() 会在首次调用时自动对原始查询字符串(req.URL.RawQuery)做一次 url.ParseQuery,完成 UTF-8 解码、+ 号转空格、%XX 还原等标准处理。手动拆分 ?key=value&key=other 容易出错,且不处理编码逻辑。
基础用法:获取单值与多值
大多数场景下,一个参数只传一个值(如 ?page=2),但协议允许重复键(如 ?tag=go&tag=web),所以设计上默认返回切片:
-
取第一个值(最常见):
req.URL.Query().Get("page")—— 返回string,未设置时返回空字符串 -
取所有同名值:
req.URL.Query()["tag"]或req.URL.Query().Get("tag")不适用,应改用req.URL.Query().["tag"]得到[]string -
检查参数是否存在:
vals, ok := req.URL.Query()["id"];若ok == true且len(vals) > 0才算真正传了值
类型转换与校验建议
Query().Get() 只返回字符串,业务中常需转为整数、布尔等。别直接用 strconv.Atoi 包裹 Get() 结果——要先判断非空再转换,避免静默失败:
立即学习“go语言免费学习笔记(深入)”;
pageStr := req.URL.Query().Get("page")if pageStr != "" {if page, err := strconv.Atoi(pageStr); err == nil && page > 0 {// 使用 page}}
更稳妥的做法是封装一个带默认值和错误处理的辅助函数,比如 queryInt(req, "limit", 20)。
注意:Query() 是惰性解析,且结果可复用
req.URL.Query() 第一次调用才真正解析,之后多次调用返回同一份 map 数据(浅拷贝)。因此它线程安全(只读),也适合在 handler 中多次取不同参数,无需担心性能或重复解析。
基本上就这些。不用额外引入库,标准 net/http 就够用,关键记住:用 Get() 简单取单值,用索引取多值,转换前先判空。










