必须先启用模块并配置代理:执行go env -w GO111MODULE=on和go env -w GOPROXY=https://goproxy.cn,direct,再go mod init myapp,最后go install github.com/kataras/iris/v12@latest并import "github.com/kataras/iris/v12"。

go get 权限不足时直接失败,别硬试
执行 go get -u github.com/kataras/iris 报 permission denied 或卡在 clone 阶段,基本是 GOPROXY 未生效、GO111MODULE 关闭,或系统级代理/防火墙拦截了 GitHub。这不是 Iris 特有问题,而是 Go 模块机制在受限网络下的通用表现。
必须开 GO111MODULE=on 且设 GOPROXY
权限不足常源于模块下载被拒绝,而根本原因是 Go 默认仍走 GOPATH 模式或直连 GitHub。国内环境必须强制启用模块并指定可信代理:
-
GO111MODULE=on是前提:否则go get会忽略go.mod,退化为旧式 GOPATH 拉取,极易因路径/权限混乱失败 -
GOPROXY必须设为可用地址:推荐https://goproxy.cn(比 goproxy.io 更稳)或https://proxy.golang.org(需科学联网) - Windows 用户注意:PowerShell 中用
$env:GO111MODULE="on",CMD 中用set GO111MODULE=on,变量名大小写敏感
用 go install 替代 go get(Go 1.17+ 推荐)
go get 在新版本中已逐步弃用,它会修改 go.mod 并尝试构建依赖,容易因本地权限或缓存污染出错。更干净的做法是:
- 先确保项目根目录有
go.mod(没有就go mod init myapp) - 运行
go install github.com/kataras/iris/v12@latest—— 它只安装二进制,不碰当前模块依赖树 - 真正引入 Iris 代码时,用
import "github.com/kataras/iris/v12",再go mod tidy自动拉取所需版本
临时绕过权限检查的底线操作
如果公司内网完全禁止外联,连 GOPROXY 都不可达,只能离线处理:
- 找一台能联网的机器,执行
go mod download github.com/kataras/iris/v12,生成完整 vendor 目录 - 把
vendor/打包拷到目标机器,运行go mod vendor+go build -mod=vendor - 切勿用
sudo go get:这会让模块缓存归属 root,后续普通用户go build可能因权限不一致报错
最常被忽略的一点:go env -w GOPROXY=... 写错地址后,go env 看起来已生效,但旧 shell 进程里的环境变量没刷新,得新开终端或重载配置文件。


















