本文介绍在 Go 的 Gin Web 框架中定义形如 /user/{userid}/status 的嵌套路由，并通过 c.Param() 安全提取路径参数的完整方法，附可运行示例与关键注意事项。
本文介绍在 go 的 gin web 框架中定义形如 `/user/{userid}/status` 的嵌套路由，并通过 `c.param()` 安全提取路径参数的完整方法，附可运行示例与关键注意事项。
在 Gin 中，路径参数（也称动态路由参数）使用冒号 : 前缀声明，而非花括号 {}（后者是某些其他框架如 Echo 或 RESTful 规范中的写法）。因此，要匹配 /user/123/status 这类 URL，正确写法是：
router.GET("/user/:userid/status", userStatus)注意：Gin 使用 :paramname 语法（如 :userid），而非 /{userid}；该参数名将作为键用于后续提取。
在处理器函数中，调用 c.Param("userid") 即可获取 URL 中对应位置的实际值：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
func userStatus(c *gin.Context) {
userid := c.Param("userid")
if userid == "" {
c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "missing userid"})
return
}
// 处理业务逻辑，例如查询用户状态
c.JSON(http.StatusOK, gin.H{
"userid": userid,
"status": "active",
})
}完整可运行示例：
package main
import (
"net/http"
"github.com/gin-gonic/gin"
)
func main() {
router := gin.Default()
router.GET("/user/:userid/status", func(c *gin.Context) {
userid := c.Param("userid")
if userid == "" {
c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "userid is required"})
return
}
c.JSON(http.StatusOK, gin.H{
"message": "status fetched for user",
"userid": userid,
})
})
router.Run(":8080") // 启动服务，访问 http://localhost:8080/user/abc123/status
}✅ 关键注意事项：
- 参数名必须严格一致：路由中写
:userid，代码中必须用c.Param("userid")，大小写敏感； - Gin 不校验参数是否为数字或符合格式，需自行验证（如用
strconv.Atoi转整型，或正则匹配）； - 若需多参数（如
/user/:uid/order/:oid），可连续调用c.Param("uid")和c.Param("oid")； - 避免在路径中混用通配符
*filepath与命名参数——二者不可共存于同一路径段。
掌握这一模式后，你可灵活构建 RESTful 风格 API，如 /posts/:id/comments/:comment_id，实现清晰、可维护的路由设计。
