执行 buffalo generate model user name:string email:string 会生成 user.go（含 pop.model 嵌入）、users.go（crud 封装）、user_test.go（测试桩）及对应 migration 文件，并自动注册到 models/models.go；字段类型按 pop dsl 映射为数据库列，如 string→text、int→integer、bool→boolean（go 字段需 *bool 支持 null）、time→timestamptz。
buffalo generate model 会生成什么
执行 buffalo generate model user name:string email:string 后，Buffalo 会在 models/ 目录下创建三个文件：user.go（结构体定义与 Pop 标签）、users.go（CRUD 方法封装）、user_test.go（空测试桩）。它还会自动把 migration 文件写入 pop/migrations/，并更新 models/models.go 的 PopTransaction 注册逻辑。
字段类型映射不等于 Go 类型直译
Pop 的字段声明语法（如 name:string）不是 Go 类型，而是 Pop 内部解析的 DSL，最终映射为数据库列类型。例如：
-
string→ PostgreSQL 的text，MySQL 的varchar(255) -
int→integer（非int64或int32） -
bool→boolean，但 Go 结构体字段必须是*bool才能支持 NULL -
time→timestamp with time zone，对应 Go 的time.Time
如果你需要自定义长度或约束（比如 email varchar(191)），不能靠 CLI 参数实现，得手动改 migration SQL 文件和 struct tag 中的 db: 字段。
Pop 模型必须嵌入 pop.Model
生成的 user.go 里会包含 pop.Model 嵌入，这是强制要求：
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
type User struct {
ID uuid.UUID `json:"id" db:"id"`
CreatedAt time.Time `json:"created_at" db:"created_at"`
UpdatedAt time.Time `json:"updated_at" db:"updated_at"`
pop.Model
Name string `json:"name" db:"name"`
Email string `json:"email" db:"email"`
}
漏掉 pop.Model 会导致 Find、Save 等方法 panic，错误信息通常是 nil pointer dereference 或 no primary key found。注意：这个嵌入不能用匿名字段别名（如 Base pop.Model），必须是裸嵌入。
迁移执行前要检查 database.yml 和环境变量
Pop 迁移依赖 database.yml 中当前环境（如 development）的配置，但 Buffalo 优先读取 DATABASE_URL 环境变量。常见踩坑点：
- 本地
database.yml配置了 PostgreSQL，但DATABASE_URL是 SQLite 路径 → 迁移跑在 SQLite 上，模型却连 PostgreSQL - 忘记
export POP_ENV=development→buffalo pop migrate up默认用test环境，表建在错库 - PostgreSQL 用户没
CREATEDB权限 → 报错permission denied to create database，但提示不明确
验证方式：运行 buffalo pop status，看输出的连接串是否符合预期。
Pop 模型不是 ORM 映射层，而是数据库 schema + 行为的耦合体；一旦你打算做微服务拆分，models/ 目录就变成单点故障——不同 service 共享同一套 model 定义，但 DB 连接、migration、甚至字段含义都可能冲突。这时候该考虑用独立的 Go 包导出 DTO，而把 Pop 模型锁死在单个 service 内部。
