必须满足go≥1.13并启用go111module=on，设置goproxy，执行go mod init后用go get github.com/kataras/iris/v12@latest安装，再通过运行main.go并访问localhost:8080验证。
要在本地Go开发环境中正确安装Iris框架，必须满足Go版本≥1.13且启用模块机制，否则会因依赖解析失败或路径错误导致安装中断。
确认Go环境与模块开关
打开终端，执行 go version 检查版本——低于1.13需先升级。若版本达标，运行 go env -w GO111MODULE=on 强制开启模块支持。这一步不可跳过，【GO111MODULE=off 时 go get 会尝试写入 GOPATH/src，而 Iris v12+ 已彻底弃用 GOPATH 模式】。
接着设置国内代理：执行 go env -w GOPROXY=https://goproxy.cn,direct。不设代理大概率卡在 golang.org/x/xxx 包下载，报错如 “dial tcp 216.239.37.1:443: i/o timeout”。
初始化项目并拉取Iris依赖
新建空目录，例如 mkdir iris-demo && cd iris-demo。
运行 go mod init iris-demo 生成 go.mod 文件——这是后续依赖管理的基石，缺失会导致 go get 无法写入 require 行。
执行安装命令：go get github.com/kataras/iris/v12@latest。注意末尾必须带 /v12 和版本后缀，直接 go get github.com/kataras/iris 会拉取已废弃的 v0.x 分支，编译报错“cannot find package 'github.com/kataras/iris' in any of…”。
验证安装是否成功
创建 main.go，内容如下：
package main<br>import "github.com/kataras/iris/v12"<br>func main() {<br> app := iris.New()<br> app.Get("/", func(ctx iris.Context) { ctx.HTML("Iris installed!") })<br> app.Listen(":8080")<br>}
终端中运行 go run main.go，无编译错误即表示依赖已正确解析；访问 http://localhost:8080 页面显示 “Iris installed!”，说明运行时链接正常。
