要在Go项目中让XORM成功连接MySQL，必须安装xorm.io/xorm和github.com/go-sql-driver/mysql驱动，使用下划线匿名导入；数据源字符串需含charset=utf8mb4、parseTime=True、loc=Local；初始化后调用Ping()验证并defer Close()；可通过ShowSQL或文件日志调试。
要在Go项目中让XORM框架成功连接MySQL数据库，必须正确构造数据源字符串并完成引擎初始化，漏掉时区或字符集参数会导致中文乱码或时间字段解析失败。
准备依赖与驱动
执行两条命令安装核心组件：
go get xorm.io/xorm
go get github.com/go-sql-driver/mysql
注意：必须先导入MySQL驱动并使用下划线匿名导入，否则NewEngine会报“sql: unknown driver mysql”错误。
构建合法的数据源字符串
数据源格式为：【username:password@tcp(host:port)/dbname?charset=utf8mb4&parseTime=True&loc=Local】
其中 charset=utf8mb4 是硬性要求，utf8 仅支持3字节编码，无法存储emoji和部分生僻汉字；parseTime=True 启用time.Time自动解析，否则datetime字段会读成字符串；loc=Local 确保时间按本地时区处理，避免+0000偏移错乱。
示例完整串：
"root:123456@tcp(127.0.0.1:3306)/testdb?charset=utf8mb4&parseTime=True&loc=Local"
初始化XORM引擎并测试连通性
第一步：调用 xorm.NewEngine 创建引擎实例，传入驱动名"mysql"和上一步的数据源字符串。
第二步：立即执行 engine.Ping() 验证连接是否可达。若失败，错误信息通常暴露在用户名密码错误、端口不通或数据库不存在等环节。
第三步：务必调用 defer engine.Close()，防止连接泄漏——XORM不会自动关闭底层连接池，不显式关闭会导致进程残留大量ESTABLISHED连接。
这一步操作起来很简单，直接把文件拖进去就行。
启用SQL日志便于调试
方法一：在引擎创建后追加 engine.ShowSQL(true)，所有生成的SQL语句将打印到标准输出。
方法二：更推荐定向到文件日志，避免污染控制台：
f, _ := os.Create("sql.log")
engine.SetLogger(xorm.NewSimpleLogger(f))
engine.Logger().SetLevel(core.LOG_DEBUG)
开启日志后，INSERT/UPDATE/SELECT 的实际参数值、执行耗时、影响行数都会清晰可见，排查WHERE条件写错或参数未绑定问题极为高效。
