buffalo generate resource users name:string email:string会生成models/user.go、迁移文件、actions/users.go、templates/users/全套文件及自动注册的RESTful路由。

buffalo generate resource 是唯一能自动生成完整模型+迁移+控制器+模板的命令,其他方式(比如手动建 models/user.go)会导致后续 pop migrate 或 c.Render 失效。
buffalo generate resource 会生成哪些文件
运行 buffalo generate resource users name:string email:string 后,它会一次性创建:
-
models/user.go:含导出结构体、TableName()方法、主键ID字段带db:"id,primarykey"标签 -
models/migrations/20261010XXXXXX_create_users.up.fizz:已写好字段定义,但需人工确认是否加nullable: true等约束 -
actions/users.go:含List、Show、Create等 7 个 handler,方法名必须原样拼写,错一个字母就 404 -
templates/users/下全套.plush.html文件 - 自动在
config/routes.go中注册 RESTful 路由(如GET /users)
为什么不能只用 buffalo generate model
Buffalo 没有 buffalo generate model 这个命令。常见误解是想跳过模板和控制器,只生成模型——但 Pop ORM 的模型不是孤立存在的:
Buffalo框架 1.0.1 版本源码包下载,适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 字段必须带
db:tag,否则app.Pop().Create()写入全为 NULL -
TableName()必须返回复数小写(如"users"),否则迁移和查询都找错表 - 若没运行 resource 命令,
models/models.go中的PopMap不会自动注册该模型 →buffalo pop migrate直接跳过这张表 - 手动建
models/user.go后,仍要自己补 migration 文件、自己写app.Pop().First()调用逻辑,极易漏掉CreatedAt或sql.NullString等关键约定
生成后必须立刻做的三件事
命令跑完不等于能用。以下检查项漏一项,buffalo dev 启动后访问 /users 就会 404 或 panic:
- 打开
models/user.go,确认ID字段有db:"id,primarykey";可空字段(如bio)必须用sql.NullString,不能用*string - 编辑刚生成的
.up.fizz文件,在字段后补上nullable: true(如果需要),再执行buffalo pop migrate - 检查
actions/users.go中所有 handler 是否以大写开头(List,不是list或Index),且函数签名严格匹配func(c buffalo.Context) error
最容易被忽略的是:生成器不会帮你设 DB_URL 环境变量,也不会启动数据库进程。哪怕所有代码都对,buffalo dev 一访问路由就会卡在 panic: connection is nil —— 先 buffalo db create,再确认 DB_URL=postgres://... 已生效,最后才跑服务。

















