buffalo 默认通过 pluralize 规则将 go 结构体名转为复数表名（如 user → users），由 gorm 控制；修改表名仅三种有效方式：结构体 tag、db.table() 临时指定、实现值接收器 tablename() 方法。
Buffalo 默认如何生成表名
Buffalo 默认使用 pluralize（复数化）规则将 Go 结构体名转为数据库表名，比如 User → users，BlogPost → blog_posts。这个行为由底层 ORM（通常是 GORM）控制，但 Buffalo 会预先配置好默认约定。
修改表名的三种有效方式
真正起作用的只有以下三种方式，顺序优先级从高到低：
- 在结构体上用
gorm:"table_name:my_custom_table"标签显式指定 —— 最直接，覆盖一切 - 在模型定义时调用
db.Table("my_custom_table")临时切换（仅对当次查询生效） - 全局重写
TableName()方法 —— 需在模型 struct 定义中实现该方法，返回字符串
例如：
type Article struct {
ID uint `json:"id" db:"id"`
Title string `json:"title" db:"title"`
}
func (Article) TableName() string {
return "posts"
}
注意：该方法必须是值接收器（func (Article) TableName()），不能是指针接收器，否则 GORM 不识别。
GORM v2 与 v1 的 TableName 行为差异
Buffalo 当前主流搭配的是 GORM v2（v1.21+），它的 TableName() 方法支持动态逻辑，比如按环境切分表：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
func (a Article) TableName() string {
env := os.Getenv("ENV")
if env == "production" {
return "prod_articles"
}
return "dev_articles"
}
但要注意：Buffalo 的迁移命令（buffalo pop migrate）运行时不会加载 os.Getenv 的运行时环境变量，除非你手动注入。所以这类动态逻辑在迁移阶段可能失效，建议只用于查询/写入阶段。
容易踩的坑：迁移不生效、表名仍为默认复数
常见原因有三个：
- 忘记在
models/models.go的Pop初始化里注册该模型（即没把 struct 加进db.AddTable(&Article{})或类似调用） - 改了
TableName()却没删掉旧的gorm:"table_name:xxx"标签，后者会优先覆盖前者 - 运行
buffalo pop migrate时用的是开发环境配置，但TableName()里写了生产环境分支逻辑，导致迁移生成了错误表名
最稳妥的做法是：开发阶段统一用标签控制，上线前确认迁移 SQL 输出是否符合预期（加 -d 参数看 debug 日志）。
表名映射本质是 GORM 层行为，Buffalo 只是封装了它；一旦涉及自定义，就得同时盯住模型定义、迁移配置和运行时环境三处，缺一不可。
