必须配置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。若因网络策略失败，立即切换国内镜像源：

XORM框架 1.3.10

XORM框架 1.3.10版本源码包下载，包含 PostgreSQL 字段同步、GBase8s 与 libSQL 驱动、Oracle 日期和 MSSQL 分页修复。

下载

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 已生成。