XORM搭建Go后端需按五步顺序：初始化项目并安装依赖→定义带xorm标签的结构体→创建引擎并用Ping和ShowSQL验证连接→用Sync2同步表结构（空库可直接建表）→封装CRUD并接入HTTP接口。
你想用XORM框架快速搭建一个能跑通数据库的Go后端服务，但不知道该先写结构体、先连数据库，还是先建表再写代码——顺序错了容易卡在Sync失败、字段映射不生效或SQL报错上。
第一步：初始化项目并安装依赖
新建项目目录，执行：go mod init myapp → 安装核心库：go get xorm.io/xorm → 根据数据库选驱动，MySQL用go get github.com/go-sql-driver/mysql。这一步漏掉驱动，后面NewEngine会panic，且错误提示只说“driver not found”，不指明缺哪个包。
注意：xorm.io/xorm 是当前官方维护主分支，不要用已归档的 github.com/go-xorm/xorm。
第二步：定义结构体并声明映射规则
在model/user.go中写结构体，字段名用Go习惯的驼峰（如UserName），不要强行匹配数据库下划线字段名——XORM默认用SnakeMapper自动转成user_name。
必须加xorm标签声明关键行为：Id int64 `xorm:"pk autoincr"`表示主键自增；CreatedAt time.Time `xorm:"created"`让插入时自动填时间；Name string `xorm:"varchar(50) notnull"`定义长度和非空约束。不加notnull却设了NOT NULL列，Sync建表会成功，但Insert时数据库报错，而Go层只返回ErrNoRows之类误导性信息。
如果表名不是结构体小写（如结构体叫User但想映射到tb_user），就实现TableName()方法：func (User) TableName() string { return "tb_user" }。
第三步：创建引擎并测试连接
在main.go或internal/db/db.go中调用xorm.NewEngine("mysql", dsn)，DSN格式为用户名:密码@tcp(地址:端口)/数据库名?charset=utf8mb4&parseTime=True&loc=Local。【parseTime=True 和 loc=Local 必须加上】，否则time.Time字段读出来是零值或解析失败。
紧接着执行engine.Ping()验证连通性。这一步不能跳过——很多新手把DSN写成root:pass@127.0.0.1:3306/db（缺tcp()包裹），Ping直接panic，但错误堆栈里看不到具体哪段URL错。
开发阶段务必开日志：engine.ShowSQL(true)，所有生成的SQL都会打印到控制台，查不出问题时第一眼就看它。
第四步：同步表结构（非空库慎用）
方法一：用engine.Sync2(new(User))。它会检查User结构体，自动创建表、新增字段、修改类型（如int→int64）、添加索引。但【不会删除字段或索引】，已有数据不受损。
方法二：生产环境推荐分步操作——先用engine.DumpAllTablesToFile("schema.sql")导出现有表结构，再人工比对差异，最后执行ALTER语句。Sync2在已有千万级数据的表上执行MODIFY COLUMN可能锁表数秒，引发接口超时。
如果数据库为空，Sync2执行完就能看到user表已建好，字段含id、user_name、created等，且created和updated字段有默认值和自动更新设置。
第五步：封装CRUD逻辑并接入HTTP接口
在service/user_service.go中写函数：func CreateUser(e *xorm.Engine, u *model.User) error { _, err := e.Insert(u); return err }。注意传入的是*model.User指针，传值会导致主键ID无法回填。
在Gin或net/http路由中调用：err := service.CreateUser(db.Engine, &user)，检查err是否为nil，不是就return c.JSON(500, gin.H{"error": err.Error()})。
查询时用e.Get(&u)查单条，e.Find(&users)查列表，e.Where("age > ?", 18).Find(&users)加条件。Where参数必须用?占位符，拼接字符串如"age > " + strconv.Itoa(18)会引发SQL注入。
