GoFrame路由匹配分标准、命名、模糊、字段四类:标准匹配优先级最高,要求路径完全一致;命名匹配用:name捕获单段;模糊匹配用*any跨段捕获;字段匹配用{field}组合多条件,优先级介于标准与命名之间。

在 GoFrame 中,路由匹配不是靠字符串简单比对,而是依据明确的层级规则和占位符语义来区分行为——标准匹配走精确路径,模糊匹配靠符号驱动范围,二者混用时优先级由深度和符号类型共同决定。
标准匹配:路径完全一致才命中
直接注册如 /user/info 这类不含任何占位符的路径,GoFrame 会将其视为标准匹配规则。
标准匹配要求请求路径与注册路径逐段完全相同,包括大小写和末尾斜杠(/user/info 和 /user/info/ 是两条不同路由)。
这一步操作起来很简单,直接把字符串传给 s.BindHandler("/user/info", handler) 即可生效。
标准匹配优先级最高,只要路径完全吻合,哪怕同级存在命名匹配或模糊匹配,它也一定先被选中。
命名匹配:用 :name 捕获单段变量
命名匹配使用 :name 语法,表示该层级只匹配一个不包含 / 的非空字符串。
方法一:注册 /user/:id → 请求 /user/123 匹配成功,r.Get("id") 可取到 "123"。
方法二:注册 /post/:year/:month → 请求 /post/2026/11 匹配,但 /post/2026/11/01 不匹配,因为 :month 后不能再有额外段。
【:name 中 name 必须全小写、仅含字母数字,不能出现下划线或大写字母】,否则启动时报错 invalid pattern。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
模糊匹配:用 *any 匹配跨段任意内容
模糊匹配用 *any 表示从当前位置开始匹配剩余全部路径(含斜杠),常用于文件服务、代理或兜底路由。
第一步:注册 /files/*path → 请求 /files/a/b/c.txt 全部被捕获,r.Get("path") 返回 "a/b/c.txt"。
第二步:注册 /*all → 所有未被前面规则捕获的请求都会落到此处,相当于全局兜底。
第三步:注意 *any 必须放在路径末尾,且每条路由最多只能有一个;/a/*x/b 是非法写法,启动时直接 panic。
这一步不能和命名匹配混用在同一层级,比如 /user/:id/*rest 是不允许的——GoFrame 不支持混合占位符。
字段匹配:用 {field} 组合多条件约束
字段匹配适用于同一层级需同时满足多个子条件的场景,例如版本+格式组合。
注册 /api/{v}/{format} → 请求 /api/v1/json 匹配,r.Get("v") 得 "v1",r.Get("format") 得 "json"。
字段名同样只接受小写字母和数字,不支持正则约束(如 {id:[0-9]+} 会报错)。
字段匹配优先级高于命名匹配,低于标准匹配;同级下 /api/v1/json(标准) > /api/{v}/{format}(字段) > /api/:v(命名) > /api/*all(模糊)。


















