url查询参数无需在路由路径中声明，gin通过c.query或c.defaultquery提取；与路由参数:id本质不同，因httprouter只解析path部分，?后查询字符串由go标准库解析，故/r.get("/search?keyword=gin")非法。
URL 查询参数（query parameters）不需要在路由路径中显式声明，Gin 不靠路径匹配它们，而是统一在 handler 里用 c.Query 或 c.DefaultQuery 提取 —— 这是和路由参数（:id）最根本的区别。
为什么不能把 query 参数写进路由定义里
Gin 的底层路由库 httprouter 只解析路径部分（path），问号 ? 及之后的查询字符串由 Go 标准库的 http.Request.URL.Query() 解析，Gin 封装了这层逻辑。所以像 r.GET("/search?keyword=gin") 这种写法是非法的，会直接 panic 或被忽略。
常见错误现象：
- 路由注册时路径含
?，服务启动失败或 404 - 误以为
c.Param("keyword")能取到 query 值，结果返回空字符串
c.Query 和 c.DefaultQuery 怎么选
两者都从 URL 查询字符串中提取值，但行为不同：
-
c.Query("key")：没传该参数时返回空字符串"" -
c.DefaultQuery("key", "default")：没传时返回你指定的默认值，比如分页场景常用c.DefaultQuery("page", "1")
使用场景建议：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 必填参数（如
?token=xxx）→ 用c.Query，后续手动判空 - 可选参数（如
?limit=20、?sort=desc）→ 用c.DefaultQuery避免反复 if 判空
多个同名 query 参数怎么处理
URL 支持重复 key，例如 /tags?name=go&name=gin&name=web，这时 c.Query("name") 只返回第一个值 "go"；要取全部，得用：
-
c.Request.URL.Query()["name"]→ 返回[]string{"go", "gin", "web"} - 或者更安全地：
c.Request.URL.Query().Get("name")等价于c.Query("name")，c.Request.URL.Query().All()可遍历所有键值对
注意：c.QueryArray("name") 并不存在 —— Gin 没提供这个方法，别搜错文档。
query 参数和路由参数混用的实际写法
比如接口设计为 GET /users/:id?include=posts,comments，既要取路径里的 id，也要取 query 里的 include：
r.GET("/users/:id", func(c *gin.Context) {
id := c.Param("id") // ← 路由参数
include := c.DefaultQuery("include", "") // ← 查询参数
c.JSON(200, gin.H{
"user_id": id,
"include": include,
})
})
这种组合很常见，但要注意：Gin 不校验 :id 是否为数字或格式合法，它只是原样透传字符串 —— 验证逻辑得你自己加，比如用 strconv.Atoi 或正则。
真正容易被忽略的是：query 参数的编码问题。浏览器会自动 encode 空格为 %20、中文为 %E4%BD%A0，Gin 内部已自动调用 url.QueryUnescape，你拿到的就是解码后的原始字符串，不用再手动处理。但如果你拼接 URL 时手写了未 encode 的中文，请求就会出错 —— 这类问题往往卡在前端，后端查不到日志，得前后端一起看 raw request。
