beego orm模型必须显式注册，否则操作报错；字段需大写导出，主键和列名不匹配时用tag标注；关联需显式声明外键字段；runsyncdb仅限开发初期使用，生产环境必须禁用。
Beego 自带 ORM 的模型定义必须显式注册才能生效
不注册就调用 orm.NewOrm()，所有操作都会报 model not registered 错误。注册不是自动扫描包，而是靠 orm.RegisterModel() 显式传入结构体指针。
常见错误现象：结构体写好了、init() 里也写了 RegisterDataBase()，但 Read() 或 Insert() 仍 panic —— 很大概率漏了注册模型。
- 必须在
init()函数中调用orm.RegisterModel(new(User), new(Post))，不能只写new(User)不加括号 - 结构体字段名首字母必须大写（Go 导出规则），否则 ORM 反射读不到
- 如果字段对应数据库列名不一致，要用
orm:"column(xxx)"显式标注，比如UpdateTime time.Time `orm:"column(update_time);type(datetime)"` - 主键默认是
Id int，若用其他字段（如ID uint64），需加orm:"pk"标签
表名和字段映射不匹配时要手动指定 TableName() 和 orm tag
Beego ORM 默认把结构体名转成复数小写作为表名（User → users），字段名转成下划线小写（UserName → user_name）。实际项目中数据库命名往往不遵循这套规则，必须干预。
使用场景：已有 MySQL 表叫 t_user，字段是 user_id、real_name，但结构体想叫 User 并保持 Go 风格命名。
- 重写
TableName()方法：func (u *User) TableName() string { return "t_user" } - 主键字段加
orm:"column(user_id);pk;auto"，避免 ORM 还去查id - 非主键字段如
RealName string `orm:"column(real_name)"` - 不要依赖
orm.RunSyncdb()自动生成表结构，它只按 tag 推导，不会改已有表；生产环境应禁用该函数
关联关系建模容易忽略外键字段声明
Beego ORM 的 rel(fk) 或 reverse(many) 标签只是查询时的“逻辑关联”，**不会自动创建外键约束或物理字段**。如果数据库没外键，Read() 带 LoadRelated 就会查不到数据或 panic。
例如定义 Post 属于 User，常见错误是只写：User *User `orm:"rel(fk)"`，却没在结构体里声明外键字段。
- 正确做法：结构体中必须显式定义外键字段，如
UserID int `orm:"column(user_id)"` - 再补上关联字段：
User *User `orm:"rel(fk);column(user_id)"`，两个地方的列名必须一致 - 一对多反查（如
User查所有Post）用Posts []*Post `orm:"reverse(many)"`，但注意这仅用于LoadRelated，不生成任何数据库字段 - 多对多需要中间表，Beego 不像 GORM 那样支持
many2many自动建表，得手写中间模型并分别定义两个rel(fk)
自动建表 RunSyncdb 仅适合开发初期，上线前必须关掉
orm.RunSyncdb("default", false, true) 会在启动时删表重建，线上跑一次等于清库。很多人在 init() 里留着这行，测试没问题，一上生产就出事。
性能与兼容性影响：它会遍历所有已注册模型，执行 CREATE TABLE IF NOT EXISTS，但字段类型推导简单（如 string → VARCHAR(255)），不兼容复杂需求（JSON 字段、全文索引、分区表等）。
- 开发阶段可设为
orm.RunSyncdb("default", false, true)（第三个参数true表示 drop 表后重建） - 测试/预发环境应改为
orm.RunSyncdb("default", false, false)（只建缺失表，不删已有） - 生产环境必须注释掉整行，改用 SQL 迁移脚本或工具（如
bee migrate）管理 schema - 如果依赖
auto主键，确保数据库引擎支持（InnoDB OK，MyISAM 有坑）
RunSyncdb 的开关时机——前者导致关联查不出数据，后者直接清空线上表。这两处不细看文档很容易跳过去。
