Gin路由参数必须显式用:param语法定义，如/user/:id，c.Param("id")才可安全获取已解码值；大小写敏感、不可重复命名、不兼容末尾斜杠，且路径参数与查询参数严格隔离。
路由定义时必须用 :param 语法
动态路径参数不是靠字符串匹配或正则推断出来的，Gin 要求你显式在路径字符串里写 :id、:name 这样的占位符。比如 /user/:id 才能触发参数捕获；写成 /user/*id 或 /user/{id} 都不会生效。
常见错误是把冒号当成装饰——c.Param("id") 只认 :id，不认 :ID（大小写敏感），也不认 :user_id（下划线不影响，但名字必须完全一致）。
- 合法：
r.GET("/post/:year/:month/:day", handler)→ 可分别调c.Param("year")、c.Param("month") - 非法：
r.GET("/post/:year/:year", ...)→ 启动 panic，报wildcard route ':year' conflicts - 末尾斜杠不自动兼容：
/user/123/不会匹配/user/:id，除非你额外注册带斜杠的路由或启用gin.DisablePathTrailingSlash
c.Param() 是唯一安全取值方式
别用 c.Request.URL.Path 自己切分，它没解码、没校验、绕过 Gin 的路径规范化（比如双斜杠 //、%2F 编码），还可能被构造路径绕过权限检查。
c.Param("id") 返回的是已解码、已从路由树中提取出的字符串，未匹配时返回空字符串，不会 panic —— 但你要自己判断是否为空、是否为数字、是否在业务范围内。
- 正确姿势：
idStr := c.Param("id"); if idStr == "" { c.AbortWithStatusJSON(400, gin.H{"error": "missing id"}) } - 错误姿势：
strings.Split(c.Request.URL.Path, "/")[2]→ 无法处理编码、忽略规范化、易出错 - 通配符
*filepath的值会带前导斜杠，c.Param("filepath")返回/css/app.css，不是css/app.css
多个参数不能靠顺序或索引推断
Gin 不保证 c.Params 切片顺序稳定，也不提供“第几个参数”这种接口。每个参数必须按名显式调用 c.Param("key")。
比如路由 /admin/:uid/role/:rid，你必须分别写 c.Param("uid") 和 c.Param("rid")，不能假设 c.Params[0].Value 就是 uid。
-
c.Params是只读切片，仅用于调试或极少数中间件场景（如统一日志打点），日常取值请无视它 - 调试时可临时加
fmt.Printf("%+v", c.Params)看实际捕获结果，但上线前删掉 - 重复 key 名（如
/a/:id/b/:id）是编译期错误，Gin 启动直接 panic，不会等到请求时才报
路径参数和查询参数绝对不能混用
c.Param() 只管路径里的 :xxx，c.Query() 只管 URL 问号后的键值对。两者存储位置、解析时机、编码处理都完全不同。
例如请求 /user/123?role=admin，c.Param("id") 得 "123"，c.Query("role") 得 "admin"；反过来调就永远拿不到值。
- 误用
c.Query("id")取路径参数 → 永远返回空字符串 - 误用
c.Param("role")取查询参数 → 永远返回空字符串，且无任何提示 -
c.DefaultQuery("id", "0")对路径参数无效，它只作用于查询参数
路径参数看似简单，但真正踩坑的地方都在「命名一致性」「解码安全性」和「上下文隔离性」上——Gin 不帮你做猜测，你写的每个 :xxx 都得和 c.Param("xxx") 严丝合缝，少一个字符、多一个下划线、大小写错位，都会静默失败。
