必须先安装XORM核心库和对应数据库驱动，再初始化引擎验证连接；执行go get xorm.io/xorm及驱动如github.com/go-sql-driver/mysql，并在代码中_导入驱动，最后用NewEngine测试连通性。
要在Go项目中使用XORM框架进行数据库操作，必须先完成依赖安装和基础环境配置，否则后续所有数据库连接、结构体映射、自动建表等操作都会因缺少核心包或驱动而报错。
安装XORM核心库
在项目根目录下打开终端，执行标准安装命令：
go get xorm.io/xorm
这条命令会拉取官方维护的稳定版XORM（v1.3+），不建议用 github.com/go-xorm/xorm 这类旧路径——它已归档，部分新特性（如 context 支持、EngineGroup 读写分离）无法使用。若项目已启用 Go Modules，该命令会自动写入 go.mod 并下载对应版本。
按需安装数据库驱动
仅安装 xorm.io/xorm 不足以连接任何数据库，必须额外安装对应驱动。常见组合如下：
方法一：MySQL（最常用）→ go get github.com/go-sql-driver/mysql
方法二：PostgreSQL → go get github.com/lib/pq
方法三：SQLite3 → go get github.com/mattn/go-sqlite3
方法四：SQL Server → go get github.com/denisenkom/go-mssqldb
【必须显式导入驱动包】 即使只写 _ "github.com/go-sql-driver/mysql"，也不能省略 import 语句，否则 sql.Open("mysql", ...) 会返回 "sql: unknown driver mysql" 错误。
初始化并验证环境是否就绪
第一步：新建 main.go，填入最小可运行连接代码：
package main
import (
"log"
"xorm.io/xorm"
_ "github.com/go-sql-driver/mysql"
)
func main() {
engine, err := xorm.NewEngine("mysql", "root:123456@tcp(127.0.0.1:3306)/test?charset=utf8mb4")
if err != nil { log.Fatal(err) }
log.Println("XORM引擎创建成功")
}
第二步：确保本地 MySQL 服务正在运行，且 test 数据库已存在（可为空库）。
第三步：执行 go run main.go。看到控制台输出 "XORM引擎创建成功"，说明安装与环境配置全部完成。
