Buffalo路由不支持自动嵌套目录匹配，所有路径必须显式注册；深层URL需用路径参数（:name）或通配符（*path）手动定义，推荐用Resource分组管理RESTful资源，并将纯静态文件置于public/下由Static中间件直接服务。
Buffalo 路由不支持自动嵌套目录匹配
Buffalo 的 app.GET() 等路由方法是显式声明的，不会像某些框架（如 Express 的 express.static()）那样自动把 /admin/users/edit 映射到 admin/users/edit.html 或对应 handler。它没有“多级目录路由映射”这个概念——你写的每条路由，都得手动注册。
常见错误现象：访问 /api/v2/posts/123/comments 返回 404，但你只写了 app.GET("/api/v2/posts", ...)，漏掉了后两级路径。
- 所有深层路径必须完整写出，比如
app.GET("/api/v2/posts/:id/comments", handler) - 不能靠文件系统结构推导路由，
./actions/api/v2/posts/comments.go不会自动绑定到/api/v2/posts/comments - 路径参数只认
:name或*wildcard，不支持类似 Rails 的(:format)后缀解析
用 :id 和 *wildcard 处理动态深层路径
真正支撑“深层 URL”的是路径参数和通配符，不是目录层级。Buffalo 的类型安全路由机制要求每个参数名在 handler 签名里显式接收，否则运行时报错或取不到值。
例如处理 /uploads/images/2024/10/abc123.jpg 这类带年月结构的路径：
app.GET("/uploads/images/*path", func(c buffalo.Context) error {
path := c.Param("*path") // 得到 "2024/10/abc123.jpg"
return c.Render(200, r.String(path))
})
-
*path必须写在末尾，且只能出现一次 - 若中间有固定段+参数混合，如
/blog/:year/:month/:slug，就得逐个声明:year、:month、:slug - 注意类型转换：Buffalo 不自动转
:year为int，需手动strconv.Atoi(c.Param("year"))
深层路由别硬塞进单个 handler，拆成资源化分组
Buffalo 推荐用 app.Resource() 管理 RESTful 资源，它会自动生成 7 个标准路由（index、show、create 等），比手写一堆 GET/POST 更清晰，也避免漏掉深层子资源。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
比如要支持 /api/v2/projects/:project_id/tasks，不要写：
app.GET("/api/v2/projects/:project_id/tasks", tasksHandler)
app.POST("/api/v2/projects/:project_id/tasks", createTaskHandler)
而是先定义子资源：
projects := app.Resource("/api/v2/projects", ProjectsResource{})
projects.Resource("/tasks", TasksResource{}) // 自动挂载到 /api/v2/projects/:project_id/tasks
- 子
Resource()默认启用嵌套路由，:project_id会自动注入子 handler 的 context - 必须确保父 resource 的 handler（
ProjectsResource）实现了Show()方法，否则:project_id无法解析 - 嵌套过深（如三层以上）会导致测试和调试变重，建议控制在两层内
静态深层路径别走路由，直接放 public/ 下
像 /uploads/thumbs/2024/10/abc123.jpg 这种纯文件访问，不该用 Buffalo 路由处理。Buffalo 启动时默认启用 app.Use(app.Static("public"))，只要文件真实存在于 public/uploads/thumbs/2024/10/abc123.jpg，就能被直接访问，不经过任何 Go 代码。
- 路径层级完全由文件系统决定，无需注册路由
- 注意权限：确保生成缩略图时写入的是
public/uploads/thumbs/...，而不是uploads/thumbs/...（缺了public/前缀就 404） - 如果用了 packr/v2 打包静态文件，记得把
public/整个目录加进packr.New()，否则生产环境找不到
深层 URL 的本质是路径设计 + 参数提取 + 静态服务分工。Buffalo 不替你猜意图，你声明什么，它就匹配什么；你放什么文件，它就发什么内容。最容易被忽略的是：嵌套路由依赖父 resource 的 Show 方法存在，以及静态文件路径必须严格落在 public/ 下——少一个斜杠，就全盘失效。
