beego.Router绑定Controller实例，走完整MVC生命周期，支持TplName、Data等字段；beego.Get/Post绑定裸函数，无Controller上下文，仅能用ctx.Input.Param()取参。
beego.Router 与 beego.Get/Post 的行为差异必须分清
用 beego.Router 注册的路径会走完整 MVC 生命周期：new controller → 执行对应方法（Get()、Post()）→ 可用 c.TplName、c.Data、c.Ctx.Input.Param()；而 beego.Get 或 beego.Post 绑定的是裸 func(ctx *context.Context)，没有 controller 实例，也就没有模板渲染、数据绑定等辅助字段。
常见错误现象：
- 在
beego.Get("/user/:id", func(c *context.Context) { c.WriteString(...) })里调c.TplName = "xxx.html"—— 无效，因为c不是*Controller - 混用两种方式注册同一路径，比如先
beego.Router("/api", &APIController{})，又写beego.Get("/api", handler)—— 后者会覆盖前者，且失去所有 controller 能力
使用场景建议：
- 需要模板、Session、Filter、ORM 自动注入 → 用
beego.Router+ Controller 结构 - 只做简单响应、转发、健康检查或集成第三方 http.Handler → 用
beego.Get/beego.Any等函数式路由
:id:int 这类写法实际不推荐直接用
:id:int 是 Beego 的简写语法，底层自动展开为 :id([0-9]+)，但它掩盖了正则细节，容易在真实业务中翻车。
立即学习“go语言免费学习笔记（深入）”；
典型问题：
- 想匹配带连字符的 UUID：
/order/:oid写成:oid:int就失败，因为int不含-，得显式写:oid([a-z0-9-]+) - 想同时支持
/user/123和/user/123.json，用:id:int无法处理后缀，得用可选段：/user/:id:int?:format -
./*和/.*行为不同：/files/*中:splat拿到的是完整剩余路径（不含开头/），而/download/.*会把路径拆成:path和:ext
实操建议：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 所有正则参数都显式写出完整正则，如
:id([0-9]{1,10})、:token([a-zA-Z0-9_\-]{32}) - 字面量点号必须转义：
/static/css\.min\.css，否则.会被当通配符 - 避免嵌套同名参数：
/a/:id/b/:id→ 第二个:id会覆盖第一个
AutoRouter 在生产环境必须禁用
beego.AutoRouter 看似省事，但它是靠反射扫描 controllers/ 下所有导出 struct 并按命名约定（Get、Post 方法 + 文件路径）自动生成路由，启动慢、不可控、无法排除特定控制器，且不支持中间件精细控制。
它还会导致这些隐性问题：
- 方法名拼错（比如写成
get()小写）→ 完全不注册，404 且无提示 - 控制器文件放在子目录（如
controllers/admin/user.go）→ AutoRouter 默认只扫一级，admin.UserController不被识别 - 想让
/api/v2/users映射到UserV2Controller.Get()，但 AutoRouter 强制路径为/userv2/get，无法自定义
正确做法：
- 开发阶段可用，但上线前必须全部替换为显式
beego.Router或NSRouter - 在
routers/router.go中集中管理，配合注释说明意图，例如：// /api/users → UserController.List (GET), UserController.Create (POST) - 用
bee run -d查看已注册路由列表，确认路径和 handler 是否符合预期
参数提取必须用 :key 形式，不能省略冒号
Beego 的参数提取严格依赖路径中定义的键名格式。写 /user/:id，就必须用 c.Ctx.Input.Param(":id") 获取，写成 c.Ctx.Input.Param("id") 或 c.GetString("id") 都返回空。
这个细节常被忽略，尤其在类型转换时：
-
c.Ctx.Input.Param(":id")返回string，安全；c.GetInt(":id")才能转int -
c.Ctx.Input.Param(":id") == ""不代表没传参，可能是空字符串；需结合c.Ctx.Input.IsExist(":id")判断是否存在 - RESTful 映射中若方法不存在（比如注册了
"get:GetUser"但GetUser()方法没定义），会 panic，不是 405
模板路径也遵循同样逻辑：MainController.Get() → 查找 views/main/get.html，大小写、文件名、目录结构缺一不可；views/Main/get.html 或 views/main/Get.html 都会报 template: : no such template。
最易被忽略的一点：路由匹配发生在 Filter 执行之前，如果 Param 提取失败（比如正则不匹配），整个请求链路会中断，Filter 甚至不会被调用 —— 这意味着日志、鉴权、统计等前置逻辑可能完全失效，排查时要优先检查路由定义是否真能匹配上。
