buffalo g resource 是唯一能批量注册路由的方式，它自动生成模型、迁移、actions 文件、模板目录，并在 routes/app.go 中调用 app.Resource() 完成整套 REST 路由注册，手动注册无法享受中间件、模板渲染、JSON 包装等配套机制。
buffalo g resource 是唯一能批量注册路由的方式
Buffalo 不支持像其他框架那样用循环或反射批量注册控制器方法。所谓“批量注册”，实际只有一种可靠路径：buffalo g resource 命令——它会自动生成模型、迁移、actions 文件、模板目录，并在 routes/app.go 中调用 app.Resource() 完成整套 REST 路由注册。
常见错误现象：
- 手写多个
app.GET("/users", UsersList)等语句：看似可行，但漏掉中间件绑定、参数解析器（middleware.ParameterParser）位置错乱，导致c.Param("id")始终为空 - 把多个 handler 函数塞进一个文件再用循环注册：Buffalo 的路由表不是运行时构建的，而是由
app.Resource()在启动时生成并写入routes.go；手动拼接不会生效 - 改写
app.Resource("users", &UsersResource{})但没实现全部方法（如漏掉Delete）：对应 HTTP 方法会返回 404，且无提示
为什么不能用 app.GET + 循环注册
Buffalo 的路由注册依赖两个硬约束：目录结构约定 + 方法名规范。比如 actions/users.go 里必须有 List、Show、Create 等固定名称的方法，app.Resource("users", &UsersResource{}) 才能按名反射调用。你写 app.GET("/api/v1/users", func(c buffalo.Context) error { ... }) 是单点注册，不参与资源生命周期，也不触发自动模板渲染、Flash 处理、CSRF 检查等配套机制。
关键影响：
- 中间件链断裂：手动注册的路由绕过
app.Use(middleware.ParameterParser)，c.Param()和c.Params()全为空 - 模板路径失效：即使写了
c.Render(200, r.HTML("users/list.html"))，若没按约定建templates/users/目录，直接 panic 报template "users/list.html" not found - 无法享受自动 JSON 包装：
app.Resource()生成的 action 默认用r.JSON()，而手动 handler 必须自己写json.NewDecoder(...).Decode()和c.Render(200, r.JSON(v))
想加版本前缀或统一前缀怎么办
buffalo g resource 默认注册在根路径（如 /users），但你可以安全地手动调整注册位置，而不是放弃它去手写一堆 app.GET。
操作步骤：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 先执行
buffalo g resource users name email，生成完整资源 - 打开
routes/app.go，找到类似users := app.Resource("/users", &UsersResource{})的行 - 改成
users := app.Resource("/api/v1/users", &UsersResource{})—— 这是唯一推荐的修改方式 - 确保该行位于所有
app.Use()中间件之后、app.Serve()之前，否则中间件不生效
注意：别试图在 app.Group("/api/v1", func(r buffalo.App) { ... }) 里套 app.Resource()，Buffalo 的 Group 不支持嵌套资源注册，会 panic 报 cannot call Resource on group。
自定义方法怎么挂到资源路由上
资源路由默认只覆盖标准 CRUD，新增动作（如 /users/{id}/activate）不能靠改 app.Resource() 参数实现，必须显式追加。
正确做法：
- 在
actions/users.go中添加新方法，签名必须是func(c buffalo.Context) error，比如func (u UsersResource) Activate(c buffalo.Context) error - 回到
routes/app.go，在app.Resource()调用后，紧跟着写：app.POST("/api/v1/users/{user_id}/activate", u.Activate) - 确保路径参数名（
{user_id}）和方法内c.Param("user_id")一致；Buffalo 不校验参数名是否匹配 struct 字段，全靠你手写对齐 - 这种追加路由仍走同一中间件链，
ParameterParser和Logger都有效，只是不享受Resource自带的自动响应包装
最容易被忽略的是：追加的路由必须放在 app.Resource() 之后，否则 u.Activate 的 receiver 变量 u 还未声明；Go 编译会直接报错，但错误信息不提示是顺序问题。
