buffalo g resource 是唯一推荐的代码生成方式，因其自动完成模型、迁移、控制器、模板及路由注册五件事；手动建文件或拼错方法名（如index而非list）、漏模板目录、省略字段定义等均会导致404、panic或渲染失败。
buffalo g resource 是 Buffalo 项目中唯一推荐的代码生成方式，其他手写控制器、模板或路由的行为会破坏框架约定，导致 404、中间件错乱或模板渲染失败。
为什么不能手动建 actions/users.go 再写 List 方法
Buffalo 的路由不是靠 app.GET() 注册出来的，而是由目录结构 + 方法名 + 资源命名三者强绑定。手动建文件并写方法，哪怕函数签名完全一致，也不会被自动注册进路由表——因为 app.Resource() 没被调用，routes.go 里根本没生成对应条目。
- 拼错方法名（比如写成
Index而非List），路由直接失效，且无任何错误提示 - 漏掉模板目录（如
templates/users/），c.Render()会 panic 报template "users/list.html" not found - 没运行
buffalo g resource，就不会触发models/user.go和迁移文件生成，pop.Transaction中间件会因找不到 model 而 panic
buffalo g resource 命令必须带字段定义
命令格式是 buffalo g resource users name:string email:string，字段定义不能省略，否则不会生成 model 和迁移。只写 buffalo g resource users 会生成空 struct 和空 migration，后续 buffalo db migrate 会成功但表里没有字段。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 字段类型必须是 Pop 支持的（如
string、int、time.Time、bool），不支持uuid或自定义类型缩写 - 复合字段（如
address:json）需后续手动改 migration 文件，CLI 不识别json - 外键字段要显式声明，如
author_id:int，不能只靠命名约定
生成后必须立刻检查这三处
命令执行完不是终点，而是校验起点。多数 404 和 DB 报错都源于这三处没核对：
-
models/user.go里字段标签是否含db:"name"？Pop 默认不映射 struct 字段到列名，漏掉就查不到数据 -
migrations/*_create_users.up.fizz是否已生成且内容含name和email字段？Fizz 语法写错（如多加括号）会导致buffalo db migrate静默失败 -
actions/users.go里所有 handler 是否仍调用c.Render()？若你打算做 API，得全部替换成c.JSON()，否则会被模板中间件拦截并报错
最容易被忽略的是：生成器不会帮你删掉 assets/ 或关掉 session.Middleware。如果你用 --api 创建项目又跑 buffalo g resource，默认生成的 HTML 模板和会话逻辑依然存在，得手动剥离——不然前端调 API 时会卡在 CSRF 校验或 session 初始化上。
