c.Query() 返回字符串，参数不存在或为空时均返回""，无法区分未传与显式传空；需用c.GetQuery()判断是否存在，类型转换须手动处理错误。
怎么用 c.Query() 拿单个 query 参数
直接调用 c.Query() 是最常用的方式，它返回字符串，如果参数不存在就返回空字符串。注意：它**不会报错，也不会 panic**，所以别指望靠它来“校验必填”——得自己判断空值。
常见错误是写成 c.Query("id") == nil，但 c.Query() 返回的是 string，不是指针，nil 判断无效；正确做法是 c.Query("id") == ""。
- 适合场景：参数可选、有默认值（比如分页的
page） - 如果前端传了
?name=（值为空），c.Query("name")也会返回""，和没传无法区分 - 性能无负担，底层只是从
c.Request.URL.Query()里取键值
c.GetQuery() 和 c.Query() 有什么区别
c.GetQuery() 返回两个值：string 和 bool，第二个值表示参数是否存在。这才是判断“用户到底传没传”的可靠方式。
比如 ?limit=10 → val, ok := c.GetQuery("limit") 中 ok 为 true；?limit= 或没传 limit，ok 都是 false（因为 URL 解析后空值不进 map）。
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 关键差异：
c.Query()看“值”，c.GetQuery()看“键是否存在” - 想支持「显式传空」语义（如清空某字段），得用
c.Request.URL.Query().Get("field")配合Has() - 别用
c.DefaultQuery()替代逻辑判断——它只在键完全缺失时生效，?q=这种情况不会触发默认值
批量取 query 参数用 c.Request.URL.Query()
当要遍历所有 query、处理重复键（如 ?tag=a&tag=b）、或需要原始未解码值时，必须绕过 Gin 封装，直取 c.Request.URL.Query()。它返回 url.Values（本质是 map[string][]string）。
常见坑：直接用 c.Request.URL.Query()["key"] 拿到的是 []string，不是 string；而 c.Query() 内部其实只取了 slice 第一个元素。
- 重复参数：
?id=1&id=2→c.Request.URL.Query()["id"]是["1","2"]，c.Query("id")只是"1" - 编码问题：URL 中的
%20会被自动解码，但如果你需要原始字节（比如签名验证），得读c.Request.URL.RawQuery - 性能提示：
c.Request.URL.Query()是惰性解析，首次调用才 parse，后续复用缓存，不用怕多次调用
query 参数类型转换容易漏掉的点
Gin 不做自动类型转换，c.Query() 永远返回 string。你要转 int、bool、time.Time，得自己用 strconv 或其他包，而且必须处理错误。
典型翻车现场：id, _ := strconv.Atoi(c.Query("id")) —— 忽略错误导致 id 为 0，和合法的 ?id=0 混淆。
- 正确姿势：先用
c.GetQuery()确认参数存在，再用strconv.ParseInt()并检查 err -
bool别信strconv.ParseBool(c.Query("flag"))：它只认"1"/"t"/"true"等，"on"或空字符串会报错 - 时间解析建议用
time.ParseInLocation()，别依赖c.Query()的字符串格式是否带时区
query 参数看着简单，但空值语义、重复键、编码残留、类型转换错误这四块最容易埋雷——尤其在前后端联调时，对方传了个 ?status= 你却当成没传，问题就藏得特别深。
