Iris 项目部署即分发静态编译的 Go 可执行文件，无需运行时环境；安装须用 go mod tidy 拉取 github.com/kataras/iris/v12，Go 版本不低于 1.19。
go get 已停用，直接 go mod tidy 拉取依赖即可——Iris 不再支持全局安装，所有项目都应基于 Go Modules 管理依赖。
确认 Go 环境是否达标
Iris 要求 Go ≥ 1.19（2026 年主流项目实际最低要求），低于该版本可能触发 unsupported Go version 错误或无法解析 v12 模块路径：
- 运行
go version检查，若输出类似go version go1.18.10 linux/amd64，需升级 - Go 1.18 及更早版本无法正确处理 Iris 的
github.com/kataras/iris/v12导入路径，会报unknown revision v12.x.x - 推荐使用 go.dev 官方下载页 安装 1.21 或 1.22 版本（截至 2026 年 9 月，LTS 推荐 1.21）
初始化项目并拉取 Iris v12
不要手动 go get github.com/kataras/iris——这个地址已重定向失效，且不带 /v12 后缀会导致模块解析失败：
- 新建空目录，执行
go mod init myapp - 在代码中首次 import
"github.com/kataras/iris/v12"（注意/v12） - 运行
go mod tidy，自动下载v12.2.11或更高兼容版（当前最新稳定版） - 若卡住或超时，可临时设置代理：
go env -w GOPROXY=https://proxy.golang.org,direct
验证安装：跑通最简 Hello World
写一个 main.go，内容只需三行核心调用，避免被中间件、路由参数等干扰初判：
package main
import "github.com/kataras/iris/v12"
func main() {
app := iris.New()
app.Get("/", func(ctx iris.Context) { ctx.WriteString("Hello Iris") })
app.Listen(":8080")
}
- 执行
go run main.go，无 panic、无 module error 即表示环境就绪 - 浏览器访问
http://localhost:8080应返回纯文本Hello Iris - 若报错
address already in use，换端口如:8081；若报undefined: iris.New，说明 import 路径漏了/v12或go mod tidy未成功
常见陷阱：为什么 go run . 会失败？
新手常把 main.go 和其他文件（如 handlers.go）放在同一目录，但没显式 import iris/v12 到 main.go 中——Go Modules 只扫描 main 包的 import，不会跨文件推导依赖：
- 即使
handlers.go里写了import "github.com/kataras/iris/v12"，go run .仍会提示missing go.sum entry - 解决方法：确保
main.go文件中至少有一行import "github.com/kataras/iris/v12"，哪怕只是占位 - 另一个隐形坑：
go.mod文件里出现require github.com/kataras/iris v12.2.11（缺/v12）是错误的，必须为github.com/kataras/iris/v12 v12.2.11
/v12 不是可选后缀，而是 Go Modules 的语义化版本强制标识——漏掉它，整个依赖链就断了。 
