必须配置GOPATH与GOROOT环境变量并初始化Go模块，执行go mod init和go mod tidy拉取xorm依赖，再通过test_xorm.go验证导入成功。
要在本地机器上完整运行基于XORM的Go项目，必须先让Go工具链识别XORM依赖并能正确编译调用，否则会出现“cannot find package github.com/go-xorm/xorm”类错误。
配置GOPATH与GOROOT环境变量
打开系统环境变量设置界面，在“系统变量”中新建或编辑以下两项：
GOROOT 值设为 Go 安装根目录，例如 【C:\go】（Windows）或 【/usr/local/go】（macOS/Linux），该路径下必须包含 bin、src、pkg 三个子目录；
GOPATH 值设为你的工作区路径，例如 【D:\goprojects】，该路径下需手动创建 src、bin、pkg 三级子目录；
将 %GOROOT%\bin 和 %GOPATH%\bin 同时追加进系统 PATH 变量——这一步漏掉会导致 go 命令在任意目录都无法识别。
初始化模块并拉取XORM依赖
进入你的项目根目录（如 D:\goprojects\src\myapp），执行：
go mod init myapp
go mod tidy
这会自动生成 go.mod 文件，并尝试从 proxy.golang.org 拉取最新版 xorm。若因网络策略失败，立即切换国内镜像源：
go env -w GOPROXY=https://goproxy.cn,direct
再执行 go mod tidy 即可完成依赖下载与校验。
验证XORM是否可用
在项目根目录下新建 test_xorm.go，内容如下：
package main
import (
"fmt"
"github.com/go-xorm/xorm"
)
func main() {
fmt.Println("XORM imported successfully")
}
执行 go run test_xorm.go，终端输出 “XORM imported successfully” 即表示环境配置成功；
若报错 “undefined: xorm.Engine”，说明 import 路径写错或版本不兼容，请确认 go.mod 中 xorm 版本为 v1.3.0 或更高；
若提示 “cannot load github.com/go-xorm/xorm: cannot find module providing package github.com/go-xorm/xorm”，请检查当前目录是否在 GOPATH/src 下，且 go.mod 已生成。
