Iris 安装失败主因是 GOPROXY 或模块版本错误，v12 是唯一稳定主线，必须用 go get github.com/kataras/iris/v12@latest；旧命令拉取 v0.x 导致编译报错，因缺失 Context 等核心定义。
直接结论：Iris 安装失败几乎全是 GOPROXY 或模块版本问题，v12 是当前唯一稳定主线，go get github.com/kataras/iris/v12@latest 是最可靠命令，旧式 go get github.com/kataras/iris 会拉取错误的 v0.x 分支并导致编译报错。
为什么 go get github.com/kataras/iris 总是失败或导入后报错
这个命令在 Go 1.11+ 模块模式下默认拉取的是未打 tag 的 master 分支快照（实际是 v0.0.2），不是 v12；它缺少 Context 类型定义、路由参数校验等核心功能，运行时会出现类似 undefined: iris.Context 或 Assets undefined 的错误。根本原因不是网络卡顿，而是模块路径语义没对齐——Iris 自 v12 起强制使用带版本号的导入路径。
- 必须用
github.com/kataras/iris/v12，不能省略/v12 - 如果项目已有
go.mod，执行前先确认GO111MODULE=on（go env -w GO111MODULE=on） - 国内环境务必设置代理：
go env -w GOPROXY=https://goproxy.cn,direct - 旧项目残留的
vendor或src/github.com/kataras/iris目录要手动删掉，否则go mod tidy仍可能复用错误版本
go get github.com/kataras/iris/v12@latest 执行后仍报 cannot find module
这是典型的模块初始化缺失。Iris v12 依赖严格遵循 Go Modules 规范，不支持 GOPATH 模式直连。
- 确保在项目根目录下执行，且该目录下已有
go.mod（没有就先go mod init your-app-name） - 不要在
$GOPATH/src下新建项目——这是 Go 1.11 前的旧习惯，现在会干扰模块解析 - 如果
go.mod里已存在旧版 iris（如github.com/kataras/iris v0.0.2），先手动删掉那一行，再运行go get github.com/kataras/iris/v12@latest - 验证是否生效：
go list -m github.com/kataras/iris/v12应输出类似github.com/kataras/iris/v12 v12.2.9
从 v11 升级到 v12 需要改哪些代码
v12 是破坏性升级，主要变更集中在包导入路径、Context 方法签名和中间件注册方式。不改会编译失败或运行时 panic。
- 所有
import "github.com/kataras/iris"改为import "github.com/kataras/iris/v12" -
iris.Context现在是接口类型，不再需要额外 importgithub.com/kataras/iris/context（Go 1.9+ 已废弃该包） -
app.Run(iris.Addr(":8080"))已弃用，改用app.Listen(":8080")或app.Run(iris.Addr(":8080"))仅在 v12.2.0+ 支持，但官方文档推荐Listen - 静态文件服务路径变更：
app.StaticWeb("/static", "./public")→app.HandleDir("/static", "./public") - 中间件注册统一为
app.Use(...)，不再支持app.UseRouter等旧方法
升级后 ctx.Params().Get("id") 返回空字符串
这不是 bug，是 v12 默认启用更严格的参数匹配规则。如果你的路由是 app.Get("/user/{id}")，但请求 URL 是 /user/（末尾多斜杠）或 /user//123（双斜杠），v12 会跳过该 handler，导致 ctx 未被正确初始化。
- 检查路由定义是否含多余斜杠，例如
/user/{id}/和/user/{id}是不同路由 - 启用调试日志：
app.Logger().SetLevel("debug")，看启动时是否打印 “Registered GET /user/{id}” - 参数类型约束可显式声明：
/user/{id:int}，这样非数字 ID 会被自动 404，避免空值逻辑分支 - 若需兼容历史写法，加全局中间件清理 URL：
app.Use(func(ctx iris.Context) { ctx.Request().URL.Path = strings.TrimSuffix(ctx.Request().URL.Path, "/"); ctx.Next() })
真正麻烦的不是安装命令本身，而是旧项目里那些没显式声明版本的 go.mod 行，以及开发机上残留的 src/github.com/kataras/iris 目录——它们会静默覆盖模块解析结果，让 go list 显示的版本和实际编译用的不一致。
