Buffalo路由与渲染强绑定：路由必须显式指向func(c buffalo.Context) error handler，且handler内须调用c.Render()等终止响应；模板路径需精确匹配文件名（含.plush），数据字段首字母大写，嵌套路由辅助函数依赖scope注册，仅plush模板中可用。
Buffalo 的路由注册和页面渲染不是松耦合关系，而是强绑定：路由必须显式指向一个 handler 函数，而该函数必须调用 c.Render() 才能触发模板渲染；漏掉任一环，页面就空白或 404。
routes.go 里注册的路径怎么对应到具体 handler
每个 app.GET("/about", AboutHandler) 这类语句，第二个参数必须是签名匹配 func(c buffalo.Context) error 的函数。它不自动从文件名或路径猜 handler，也不支持字符串形式的“控制器名”。
- handler 函数名可以任意，但必须在
actions/目录下定义（如actions/about.go），且 import 路径要对（import "yourapp/actions"） - 函数体里必须有
c.Render()或c.Redirect()等终止响应的调用，否则请求会 hang 住 - 如果 handler 返回
nil但没调c.Render()，Buffalo 默认返回 204 No Content，浏览器看起来就是白屏 - 路径参数（如
/posts/{id}）会自动注入c.Param("id")，但不会自动传给模板——得手动c.Set("post", post)才能在templates/posts/show.plush.html里用
为什么模板路径写对了却渲染出空白页
常见原因是 c.Render() 调用时传入了错误的模板名或数据结构，或者模板本身语法错误但被静默忽略。
-
c.Render(200, r.HTML("posts/show.html"))中的路径必须和文件系统完全一致：templates/posts/show.plush.html→ 必须写"posts/show.plush"，不能省略.plush - 如果用了
r.Auto(c, data)，data 对象的字段名首字母必须大写（Go 导出规则），否则 plush 模板里取不到值 - 模板里调用未定义变量（如
但c.Set("user", nil)）不会报错，只会渲染空字符串，排查时容易误判为逻辑问题 - 修改模板后 buffalo dev 不一定实时重载——尤其当
templates/下有语法错误时，plush 编译失败会缓存旧版本，需手动重启进程
如何让同一个 handler 渲染不同模板（比如 PC 和移动端）
Buffalo 不提供内置设备检测，但你可以基于 User-Agent 或 URL 参数手动切换，关键是把模板名变成变量。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 不要写死
r.HTML("posts/index.plush")，改用r.HTML(templateName)，其中templateName := "posts/index.plush" - 判断条件示例：
if strings.Contains(c.Request().UserAgent(), "Mobile") { templateName = "posts/index_mobile.plush" } - 更稳妥的方式是加 query 参数：
/posts?view=mobile，然后c.Param("view") == "mobile" - 注意：所有分支路径都必须确保
templateName指向真实存在的文件，否则c.Render()会 panic 并返回 500
嵌套路由下模板里的辅助函数怎么生成正确 URL
Buffalo 的路径辅助函数（如 postsPath()、postCommentsPath()）不是全局可用的，它们依赖路由注册时的命名和参数结构。
- 嵌套资源必须用
app.Scope("/posts/{post_id}", ...)注册，否则postCommentsPath({post_id: 1})会生成/comments而非/posts/1/comments - 辅助函数名由路由前缀 + 资源名拼接，
app.Resource("/comments", CommentsResource{})在 scope 内注册 → 生成postCommentsPath()，不是commentsPath() - 模板中调用时必须传入完整参数对象：
postCommentsPath({post_id: post.ID})，漏掉post_id字段就会 404 - 如果用了
app.Group("/api").Resource(...)，辅助函数名会带前缀，如apiPostsPath()，不能和根路径的postsPath()混用
最常被忽略的是：辅助函数只在 templates/ 下的 plush 文件里可用，在 actions/ 的 Go 代码里调用会编译失败；而 c.Request().URL.Path 是唯一能在 handler 里安全获取当前路径的方式。
