必须先开启GO111MODULE并配置GOPROXY,再执行go mod init和go get github.com/kataras/iris/v12@latest;漏掉/v12或未初始化模块会导致拉取v11、路径不匹配、编译失败。

直接用 go get 安装 Iris 会失败,根本原因是模块代理没开、版本路径写错、或 GOPROXY 没配——不是框架问题,是 Go 模块生态在国内的常规卡点。
确认 Go 版本和模块开关
Iris v12 要求 Go ≥ 1.13,且必须启用 Go Modules。运行以下命令验证:
go version go env GO111MODULE
如果输出 GO111MODULE=off,必须先开启:
go env -w GO111MODULE=on- 国内用户务必同步设置代理:
go env -w GOPROXY=https://goproxy.cn,direct - 不建议用
go get -u(已废弃),v12 后统一走@latest或指定语义化版本
安装 Iris v12 的正确命令
在项目根目录下执行(不是全局):
go get github.com/kataras/iris/v12@latest
成功后检查 go.mod 是否新增了这一行:
github.com/kataras/iris/v12 v12.2.9
注意点:
- 路径末尾必须带
/v12,漏掉会拉取旧版(v11 或更早)甚至失败 - 不要用
github.com/kataras/iris(无版本后缀),它默认指向 v11,与当前文档和 API 不兼容 - 如果提示
no matching versions,说明 GOPROXY 没生效,重试前先go env -p确认配置已写入
验证安装是否可用
新建 main.go,写最简启动代码:
package main
import "github.com/kataras/iris/v12"
func main() {
app := iris.New()
app.Get("/", func(ctx iris.Context) {
ctx.Text("Hello from Iris v12")
})
app.Listen(":8080")
}
运行:go run main.go。能访问 http://localhost:8080 并看到文字,说明安装和依赖解析都通过。
常见失败现象:cannot find package "github.com/kataras/iris/v12" —— 99% 是 GO111MODULE 关闭或 go.mod 文件不存在(此时需先 go mod init your-project-name)。
为什么不用 go install 或全局安装?
Iris 不提供可执行命令,go install 对它无效;所谓“安装”本质是把源码下载到 $GOPATH/pkg/mod 并记录进 go.mod。重点在于模块初始化和代理配置,而不是“装到系统里”。很多人卡在这一步,反复重装却忽略 go.mod 是否存在、GO111MODULE 是否真开启——这些才是实际起效的开关。


















