gorm中表名字段映射优先用tablename()处理动态场景，静态映射用gorm:"table_name:xxx"和gorm:"column:xxx"；tablename()覆盖tag，嵌套结构体、关联表、中间表需单独配置否则静默失效。
直接结论：GORM 中控制表名和字段映射，优先用 TableName() 方法处理动态/多租户场景，静态映射优先写 gorm:"table_name:xxx" 和 gorm:"column:xxx" tag；混用时 TableName() 一定覆盖 tag，但嵌套结构体、关联表、中间表需单独处理，否则静默失效。
怎么用 struct tag 写死表名和字段名
这是最常用也最容易出错的方式。GORM 不会自动识别字段是否该映射，全靠 tag 显式声明。
-
gorm:"table_name:sys_user"写在 struct 上，强制整张表用这个名字，跳过默认蛇形复数规则（UserProfile→user_profiles） -
gorm:"column:user_id;primaryKey"写在字段上，表示数据库列叫user_id，且是主键；此时 GORM 不再把ID当默认主键，漏写primaryKey就不会建PRIMARY KEY -
gorm:"-"表示完全忽略该字段，比如只读计算字段FullName，不参与任何 SQL 生成 - 别漏
gorm:"type:varchar(100)"或gorm:"size:100"——string默认建varchar(255)，但遗留库可能是text或char(32)，类型不匹配会导致迁移失败或数据截断
为什么 TableName() 方法比 tag 更关键
当你需要按租户、时间、环境等条件动态切表时，tag 的字符串字面量就彻底不够用了。
- 必须是指针接收者：
func (u *User) TableName() string，写成func (u User) TableName() stringGORM 根本找不到这个方法 - 返回值直接当表名用，不做任何转换，所以你要自己拼前缀、处理大小写，例如：
return "tenant_" + u.TenantID + "_users" - 这个方法只影响当前 struct 的 CRUD，
HasMany关联的 struct 不会继承，得给Order、Item各自实现TableName() - 如果同时写了
gorm:"table_name:xxx"和TableName()，后者一定生效，前者被无视
多对多中间表字段名不匹配怎么办
错误现象：column reviews_group_users.reviews_group_id does not exist——这是 GORM 默认外键命名（reviews_group_id）和你数据库实际列名（group_id）不一致导致的。
- 别指望
many2many:tag 能修好字段名，它只控制中间表名，不控制列名 - 正确做法是定义中间表 struct，显式声明字段和列名：
GroupID uint `gorm:"column:group_id;not null"` - 然后在主模型里用一对多替代 many2many：
ReviewsGroups []ReviewsGroup `gorm:"many2many:reviews_group_users;joinForeignKey:UserID;joinReferences:ID"`，其中joinForeignKey指向中间表的字段名（不是 struct 字段名） - 中间表 struct 必须自己加
gorm:"primaryKey"，否则 AutoMigrate 不会建主键
嵌套结构体和 gorm.Model 的坑在哪
匿名字段不会自动“扁平化”到数据库列，这是新手最常误判的一点。
- 嵌入
gorm.Model是为了省事带ID、CreatedAt等字段，但它和手写ID string `gorm:"primaryKey"`混用会触发duplicated primary key错误 - 想用 UUID 主键？删掉
gorm.Model，自己写ID uuid.UUID `gorm:"primaryKey;type:char(36)"` - 嵌套 struct（如
Address）默认不展开，字段不会变成address_city，除非你手动加gorm:"embedded"，且嵌入字段也要单独加columntag -
gorm:"embedded"不会自动加前缀，City string `gorm:"column:addr_city"`才能真正控制列名
最麻烦的其实是组合场景：分表 + 自定义中间表 + 嵌套审计字段。这时候每个 struct 都得独立考虑 TableName()、column、embedded 是否生效，少一个 tag 或接收者类型写错，就只能翻日志看生成的 SQL 才能定位问题。
