必须先执行go mod init初始化模块并指定全小写无下划线的模块名,再用go get github.com/kataras/iris/v12@latest显式拉取v12版本;import路径必须为github.com/kataras/iris/v12,否则因版本错配导致编译失败、类型不兼容。

不设 GO111MODULE=on 或漏掉 /v12,go get 会拉错版本、编译失败、类型不兼容——这是 90% 新手跑不起来 Iris 的根本原因。
go mod init 必须在项目根目录执行,模块名不能含大写或下划线
模块名不是随便起的,它会成为 import 路径的一部分。如果写成 go mod init MyApp,后续 import "github.com/kataras/iris/v12" 就可能因路径不一致触发解析失败(尤其在 vendor 场景下)。
- 正确做法:进到你的项目目录(比如
~/my-project),运行go mod init myproject(全小写、无空格、无下划线) - 检查生成的
go.mod文件第一行是否为module myproject,不是就删掉重来 - 模块名无需真实存在、也不必对应 GitHub 路径,但必须和你代码里
import的包路径逻辑自洽
go get 必须带 /v12@latest,否则默认拉 v11 兼容层
Iris v12 是完全重构的大版本,github.com/kataras/iris(无 /v12)会命中旧版 v11 的 import 路径,导致 iris.Context 类型找不到、app.Run() 参数不匹配等编译错误。
- 执行
go get github.com/kataras/iris/v12@latest,不是go get github.com/kataras/iris - 国内用户务必提前设置代理:
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy,https://proxy.golang.org - 执行后检查
go.mod是否新增了类似github.com/kataras/iris/v12 v12.2.11的行;没有就说明没拉成功 - 别信
go get -u自动升级——Iris v12 不向下兼容,强制指定@latest更可控
依赖下载位置不在 GOPATH/src,而在 $GOPATH/pkg/mod
启用 modules 后,Go 工具链彻底绕过 $GOPATH/src,所有依赖都缓存在 $GOPATH/pkg/mod 并按模块路径+版本号隔离存储。这意味着:
- 你不能再手动把 Iris 源码扔进
./vendor/github.com/kataras/iris然后指望import "github.com/kataras/iris"生效——modules 下 vendor 不参与 import 解析 -
go build时若提示 “cannot find package”,先确认go.mod里有require行,再确认当前目录是模块根目录(有go.mod) - 想锁定全部依赖到本地
vendor/目录(比如发给没网的同事),用go mod vendor,之后构建时加-mod=vendor参数
main.go 里 import 路径必须带 /v12
哪怕 go.mod 写对了,import 语句写错照样报错。v12 的所有公开 API 都在 github.com/kataras/iris/v12 下,不是 github.com/kataras/iris。
- 正确写法:
import "github.com/kataras/iris/v12",以及"github.com/kataras/iris/v12/middleware/logger" - 错误写法:
import "github.com/kataras/iris"(这会找 v11)、import "github.com/kataras/iris/v13"(不存在) - IDE 报红但能运行?大概率是 Go 插件索引没刷新,执行一次
go mod tidy或重启 IDE
最易忽略的一点:go run main.go 成功不代表服务已启动——Iris 实例必须显式调用 app.Listen() 或 app.Run(),否则进程静默退出,netstat -an | grep 8080 根本查不到监听端口。


















