XORM日志与映射需协同配置：ShowSQL控制SQL日志触发，Logger决定输出目标与格式，命名策略（Snake/Same/Prefix）影响字段到列名转换，且结构体tag优先级最高。
要在Go项目中精准控制XORM框架的日志输出、SQL可见性与结构体字段到数据库列名的映射逻辑，必须逐项配置ShowSQL、Logger及命名策略——这些不是开关式选项，而是相互影响的三层控制：ShowSQL决定是否触发日志路径，Logger决定日志去向与格式，命名策略则在建表、查询、插入前就已介入字段解析。
ShowSQL开关与行为边界
启用ShowSQL仅让Engine在执行SQL时调用Logger打印语句，【它本身不创建日志器，也不写文件】。若未设置Logger，开启ShowSQL只会往标准输出（console）打印，且仅限debug级别。
执行engine.ShowSQL(true)后，所有Insert/Update/Delete/Select操作生成的SQL都会被记录；设为false则完全跳过日志流程，性能无额外损耗。
注意：ShowSQL=false时，即使你设置了自定义Logger，SQL也不会被记录——这是硬性拦截点，不是日志级别过滤。
Logger配置的三种落地方式
方法一：绑定到标准输出并设为DEBUG级别
engine.Logger().SetLevel(core.LOG_DEBUG)
方法二：重定向到文件（需提前创建文件句柄）
f, err := os.Create("sql.log")
if err != nil { println(err.Error()); return }
engine.SetLogger(xorm.NewSimpleLogger(f))
方法三：使用自定义SQLLogger实现条件日志（例如只记录耗时>100ms的SQL）
type SQLLogger struct { showSQL bool; threshold time.Duration }
func (s *SQLLogger) AfterProcess(c *contexts.ContextHook) error { if !s.showSQL || c.ExecuteTime logger.Infof(c.Ctx, "SLOW SQL: %s, ExecTime: %v", c.SQL, c.ExecuteTime)
return nil }
命名策略：从结构体字段到数据库列名的转换规则
第一步：确认当前使用的命名策略类型
XORM内置三种策略：
① SnakeStringMapper（默认，如UserName → user_name）
② SameMapper（原样映射，UserName → UserName）
③ PrefixMapper（加前缀，如TableName{Prefix: "t_"} → t_user_name）
第二步：全局设置Engine级命名策略
engine.SetTableMapper(core.SnakeStringMapper{})
engine.SetColumnMapper(core.SnakeStringMapper{})
第三步：对单个结构体覆盖策略（优先级更高）
type User struct {
ID int64 `xorm:"pk autoincr"`
Name string `xorm:"name"` // 强制映射为列名"name"，无视全局Snake规则
}
⚠️关键限制：【一旦结构体字段已用xorm tag明确指定列名，命名策略对该字段完全失效】。比如写了`xorm:"user_nickname"`，无论全局设Snake还是Same，都固定生成user_nickname列。
组合生效顺序与调试验证
启动时按此顺序生效：全局命名策略 → 结构体tag覆盖 → ShowSQL开关判断 → Logger接收并输出。
验证是否生效最直接的方式是调用engine.ShowSQL(true)，然后执行一句简单查询：
_, err := engine.Query("select 1")
观察控制台或日志文件是否出现"SELECT 1"语句。
若无输出，先检查engine.Logger()是否为nil，再确认ShowSQL是否为true，最后看是否因字段全带xorm tag导致SQL生成路径被绕过。
