Buffalo generate model 失败主因是未在项目根目录执行：需先 buffalo new myapp 初始化，再运行 buffalo dev 或 go build 完成首次构建，否则提示 command not found 或 no generator named 'model'。
buffalo generate model 命令生成失败的常见原因
直接运行 buffalo generate model user 却提示 “command not found” 或 “no generator named 'model'”，不是 Buffalo 版本太新或太旧，而是你当前目录不在 Buffalo 项目根路径下——该命令必须在 buffalo new myapp 初始化后的项目目录中执行，且项目需已完成首次构建（即已运行过 buffalo dev 或 go build）。
生成 model 后，数据库字段怎么映射到 struct 字段
Buffalo 默认使用 Pop（内置 ORM），buffalo generate model user name:string email:string age:int 会生成带标签的 struct，但字段名和数据库列名不是简单一一对应：
-
name string→ 数据库列名为name，类型为VARCHAR（SQLite/PostgreSQL）或TEXT（MySQL） -
age:int→ 列名为age，类型为INTEGER，但不会自动加NOT NULL；如需非空，得手动在 struct tag 加sql:",notnull" - 主键默认是
ID uint64+CreatedAt, UpdatedAt time.Time，不可省略或覆盖，否则 Pop 迁移会报错 - 外键字段命名必须为
xxx_id（如role_id uint），Pop 才能自动识别关联关系
迁移文件没生成或执行报错：pop migrate up 失败
生成 model 后，Buffalo 会自动创建 models/migrations/xxx_create_users.up.fizz，但这个文件依赖 fizz 语法，不是纯 SQL。常见问题包括：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 字段名含大写字母（如
FirstName:string）→ fizz 解析失败，必须全小写（first_name:string） - 使用了不支持的类型缩写（如
bool）→ fizz 只认boolean，否则迁移时 panic - 数据库未启动或连接配置错误（
database.yml中url指向 localhost:5432 但 PostgreSQL 没运行）→ 报错信息是failed to connect to `host=localhost user=...`: dial error - 重复运行
pop migrate up→ 不会跳过已执行的迁移，需先pop migrate down再重试，或删掉schema_migrations表中的对应记录（仅开发环境）
生成的 model 怎么加自定义验证逻辑
Pop 的验证不是靠 struct tag 驱动，而是在 model struct 实现 Validate 方法。比如要限制 email 格式：
func (u *User) Validate() *validate.Errors {
return validate.Validate(
&validate.Length{Field: u.Email, Name: "Email", Min: 1, Max: 255},
&validate.Email{Field: u.Email, Name: "Email"},
)
}
注意两点：
- 必须返回
*validate.Errors类型，不能是error - 验证只在调用
u.Create(tx)或u.Update(tx)时触发，u.Save(tx)不校验 - 如果用了
buffalo pop命令生成 migration，别手动改.up.fizz文件里的列定义，否则结构体和 DB schema 会脱节
