ctx.query("id")在参数不存在或为空时均返回""；defaultquery仅在key完全未出现时用默认值；getquery返回string和bool，bool标识key是否显式存在；queryarray/querymap支持批量解析；shouldbindquery自动类型转换与校验。
直接用 ctx.Query 就能取到 URL ? 后面的参数，但多数人卡在默认值、类型转换、空字符串判断和数组解析上——这些不是“不会”，而是没踩过坑就容易写错。
Query 和 DefaultQuery 的区别到底在哪
两者都从 ctx.Request.URL.RawQuery 解析，但行为不同：
-
ctx.Query("id")：参数不存在或值为空（如?id=）时，一律返回空字符串"" -
ctx.DefaultQuery("id", "0")：只有参数完全没传（URL 里压根没id=）才用默认值；?id=这种仍返回"" - 别用
DefaultQuery做“空值兜底”，它不处理?name=这类显式空值
判断参数是否真实存在得用 GetQuery
ctx.GetQuery("token") 返回两个值：string 和 bool。这个 bool 才是关键：
-
true表示 URL 中明确出现了该 key（哪怕值是空，如?token=） -
false表示整个 key 没出现（如/api?user=123调用GetQuery("token")） - 常见误用：
if ctx.Query("id") != ""→ 会把?id=当作有值，实际是空提交
批量取参数：QueryArray 和 QueryMap
当 URL 带数组或嵌套结构时，别手动 strings.Split：
-
?ids=1&ids=2&ids=3→ctx.QueryArray("ids")返回[]string{"1","2","3"} -
?user[name]=alice&user[age]=25→ctx.QueryMap("user")返回map[string]string{"name":"alice","age":"25"} - 注意：
QueryMap不支持多层嵌套（如user[profile][city]），会截断成profile[city]
想转 int 或 struct？别自己 parse，用 BindQuery
手动调 strconv.Atoi(ctx.Query("id")) 容易 panic，且没校验：
- 定义结构体加
formtag：type UserQuery struct { ID int64 `form:"id" binding:"required,min=1"` Name string `form:"name" binding:"required,max=20"` } - 调用
err := ctx.ShouldBindQuery(&u)→ 自动类型转换 + validator 校验 -
ShouldBindQuery和BindQuery区别：前者出错不中断，后者出错直接 400；生产环境优先用ShouldBindQuery - 如果只想要转换不校验，用
ctx.BindQuery即可，它内部已处理空值、类型错误等边界
最常被忽略的是：Query 参数解析发生在第一次调用 Query/BindQuery 等方法时，结果缓存在 ctx.queryCache；后续调用都是读缓存。所以改 ctx.Request.URL.RawQuery 不会影响已缓存的值——这点在中间件里伪造参数时特别容易翻车。
