根本原因是go get未显式指定/v12路径导致fallback至不兼容的v11，且go mod init缺失、GOPROXY未针对当前Go版本配置、IDE缓存或go.sum残留共同引发版本错乱。
go version 切换后，go get 仍拉错 Iris 版本？
根本原因不是 Go 版本切换失败，而是 go get 默认不带版本路径时会 fallback 到 v11 —— 即使你用的是 Go 1.21，只要没显式写 /v12，就大概率装上一个无法运行的旧版。Iris v12 要求 import 路径必须是 github.com/kataras/iris/v12，v11 的路由写法、iris.Context 类型、中间件注册方式全都不兼容。
go mod init 必须在 go get 前执行
模块初始化不是可选项，它是 Go 模块语义化版本解析的前提。没 go mod init 就直接 go get github.com/kataras/iris/v12@latest，Go 会降级为 golang.org/x/net 等间接依赖的旧快照，导致后续 go build 报错或运行时 panic。
- 先确认当前目录是空项目根目录，执行
go mod init myapp（myapp替换为你自己的模块名） - 检查生成的
go.mod文件第一行是否为module myapp，不是则手动修正 - 再执行
go get github.com/kataras/iris/v12@latest，成功后go.mod中应出现类似github.com/kataras/iris/v12 v12.2.5的行，且不含+incompatible
多版本 Go 共存时，GOPROXY 和 GO111MODULE 必须全局生效
不同 Go 版本（如 1.19 / 1.21 / 1.23）各自独立管理环境变量。你在 Go 1.21 下设了 GOPROXY，切到 Go 1.19 后这些设置不会自动继承，容易因网络问题卡在 go get 或拉取错误 commit。
- 对每个 Go 安装版本，都需单独执行：
go env -w GO111MODULE=on和go env -w GOPROXY=https://goproxy.cn,direct - 验证方式：切换 Go 版本后运行
go env GOPROXY，输出应为https://goproxy.cn,direct - 若仍报
golang.org/x/net类错误，说明代理未生效，优先检查go env -w是否针对当前 shell 的 Go 版本执行
IDE 缓存和 go.sum 残留会导致“明明装了 v12 却报 v11 错误”
这是最隐蔽的问题：IDE（如 GoLand）或 VS Code 的 Go 扩展可能缓存了旧的 module 解析结果；更常见的是，项目里残留了旧版 go.sum 或 vendor/ 目录，让 go build 表面成功，实际加载的是 v11 的符号。
- 执行
go clean -modcache清掉本地 module 缓存 - 删掉项目下的
go.sum和vendor/（如有），再跑go mod tidy - 重启 IDE，或在 VS Code 中按
Ctrl+Shift+P→ “Go: Restart Language Server” - 最后写个最小验证文件，确保
import "github.com/kataras/iris/v12"能通过，且ctx.HTML不报 red underline
真正麻烦的从来不是切换 Go 版本，而是每个版本下都要重置模块环境、清缓存、验 import 路径——漏掉任意一环，iris.Context 就会变成未定义，而错误信息往往只提示 “cannot use ctx (type context.Context) as type iris.Context”，根本看不出是版本混了。
