Gin用冒号:定义路径参数，如/user/:id；c.Param("id")提取值，仅匹配路径段不处理查询参数；支持多参数、大小写敏感、正则约束:id；需手动类型转换并校验空值，不与查询参数混用。
如何在Gin路由中定义并提取路径参数
Gin用冒号:声明URL路径参数，比如/user/:id中的:id会被自动捕获。定义路由时必须显式写出参数名，不能靠正则或通配符隐式匹配。
常见错误是把路径写成/user?id=123（查询参数）却用c.Param("id")去取——这会返回空字符串，因为Param只读路径段，不读?xxx部分。
- 正确写法：
r.GET("/user/:id", handler)→ 访问/user/123时c.Param("id")得"123" - 支持多个参数：
/user/:uid/post/:pid→ 可分别取c.Param("uid")和c.Param("pid") - 参数名区分大小写：
:ID和:id是两个不同参数
c.Param()的返回值和空值处理
c.Param()总是返回string，即使路径里是数字，也得手动转类型。它不会报错，哪怕参数根本不存在——此时返回空字符串""，容易引发后续逻辑崩溃。
别直接用c.Param("id") == ""判断缺失，因为合法路径可能真包含空段（虽然少见）。更稳妥的是结合gin.Context.FullPath()或路由定义做校验。
- 安全转换示例：
idStr := c.Param("id")<br>if idStr == "" {<br> c.AbortWithStatusJSON(400, gin.H{"error": "missing id"})<br> return<br>}<br>id, err := strconv.Atoi(idStr)<br>if err != nil {<br> c.AbortWithStatusJSON(400, gin.H{"error": "invalid id format"})<br> return<br>} - 注意：Gin不校验参数是否“存在”，只按路由模板匹配路径，所以
/user//post/1中c.Param("uid")也是""
带正则约束的路径参数怎么写
Gin支持用regexp语法给参数加校验，避免无效请求进handler。格式是:param_name，比如:id确保id全是数字。
正则写错会导致整个路由不生效，且无提示——Gin静默跳过非法正则的路由注册。调试时可打印r.Routes()看注册结果。
- 常用模式：
/:name（非斜杠字符）、/:slug（URL友好字符串） - 错误示例：
:id（反斜杠在Go字符串里要双写：\d+） - 性能影响：正则校验发生在路由匹配阶段，复杂正则会拖慢整体路由查找，简单字符集优先用
[0-9]而非\d
和查询参数、表单数据混用时的注意事项
路径参数、查询参数（c.Query()）、表单字段（c.PostForm()）三者完全独立，名字冲突也不会覆盖。比如/user/:id?name=alice中，c.Param("name")是""，c.Query("name")才是"alice"。
新手常误以为c.DefaultQuery("id", "1")能兜底路径参数，其实不能——DefaultQuery只对?id=xxx有效，对/user/123里的:id无感。
- 混合取值顺序建议：路径参数（强约束资源标识）→ 查询参数（可选筛选）→ 表单/JSON（操作数据）
- 如果业务上路径参数和查询参数语义重叠（如都叫
id），务必在文档或注释里明确优先级，避免前端传错位置 - Gin的
c.ShouldBind()默认不绑定路径参数，需手动合并到结构体或map中
路径参数的解析发生在路由匹配瞬间，一旦注册完成就不可变；正则约束和参数名拼写错误是最隐蔽的坑，建议单元测试覆盖边界路径。
