需先启用go111module=on,再配置goproxy为阿里云镜像等多级代理,最后执行go get下载iris;否则因境外仓库超时导致失败,且代理设置在模块关闭时无效。

在Windows或Linux系统中使用go get安装Iris框架时,因默认代理指向境外模块仓库,常出现超时、连接失败或卡在“fetching”状态,导致依赖无法下载完成。
确认Go模块功能已启用
打开命令行终端,执行以下命令检查当前模块模式:
go env GO111MODULE
若输出为 off,说明模块功能未开启,必须先启用——否则后续代理设置无效,【GO111MODULE=off时设置GOPROXY完全不起作用】。
立即执行启用命令:
go env -w GO111MODULE=on
配置国内代理地址
推荐使用阿里云镜像源,稳定且CDN覆盖广。执行以下两条命令(顺序不可颠倒):
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,https://goproxy.cn,direct
该配置采用多级 fallback:优先走阿里云 → 次选 goproxy.cn → 最后直连(direct)。其中 direct 是必需的兜底项,否则私有模块或本地 replace 会失效。
注意:不要用 set GOPROXY=... 临时设置,它只在当前终端生效,关掉就丢失;go env -w 是永久写入用户级环境变量,重启终端也有效。
验证代理是否生效
执行一次轻量级探测:
go list -m -f '{{.Name}}: {{.Version}}' github.com/kataras/iris/v12@v12.2.9
如果返回类似 github.com/kataras/iris/v12: v12.2.9,说明代理已通;若报错 Get ...: dial tcp: i/o timeout,请检查网络是否能访问 mirrors.aliyun.com,或尝试更换为 https://goproxy.cn 单源配置。
下载Iris框架本体
进入你的项目根目录(确保已有 go.mod 文件,若无则先运行 go mod init your-project-name),执行:
go get github.com/kataras/iris/v12@latest
这一步会自动拉取 v12 最新稳定版及全部间接依赖。首次运行可能耗时 10~30 秒,期间终端会显示模块解析与下载进度,【切勿中途 Ctrl+C,否则 go.mod 和 go.sum 可能处于不一致状态】。
下载完成后,检查 go.mod 文件末尾是否新增了 iris 相关行,形如:
github.com/kataras/iris/v12 v12.2.9











