能跑通 iris.Default() 并返回 HTTP 200 即安装成功；需先执行 go mod tidy 确保依赖完整，检查 go.mod 含 github.com/kataras/iris/v12 v12.0.0，启用 GO111MODULE=on，用最小 main.go 验证，排除端口占用与防火墙干扰。
能跑通 iris.Default() 并返回 HTTP 200，就说明安装成功了——别信 go get 输出的 “downloaded” 就完事，那只是把代码拉下来，不等于能编译运行。
验证前先确认 Go 模块和依赖已就位
运行 go mod tidy 是必须动作。Iris v12 依赖 github.com/kataras/golog、github.com/BurntSushi/toml 等子模块，如果本地没走代理或镜像，go get 可能静默跳过部分依赖（尤其在大陆网络环境下）。常见现象是：编译通过，但一执行就 panic 报 undefined symbol: golog.New 或类似错误。
- 检查
go.mod中是否包含github.com/kataras/iris/v12 v12.0.0（注意末尾/v12和版本号） - 确保
GO111MODULE=on已启用，否则go get会降级到 GOPATH 模式，导致路径混乱 - 若提示
golang.org/x/net类错误，手动克隆对应仓库到$GOPATH/src/golang.org/x/下（如git clone https://github.com/golang/net.git）
写一个最小可运行程序并执行
不要抄文档里带中间件、视图、静态文件的“完整示例”，从最简开始。新建 main.go：
package main
import "github.com/kataras/iris/v12"
func main() {
app := iris.Default()
app.Get("/health", func(ctx iris.Context) {
ctx.JSON(iris.Map{"status": "ok", "iris": "v12"})
})
app.Run(iris.Addr(":8080"))
}
然后终端执行：
-
go run main.go—— 正常应输出[INFO] Now listening on: http://localhost:8080 - 另开终端
curl -i http://localhost:8080/health—— 应返回HTTP/1.1 200 OK和 JSON 内容 - 若报
command not found: go或package github.com/kataras/iris/v12: cannot find module，说明 Go 环境或模块未初始化，回退上一步检查
常见失败点：端口占用与防火墙静默拦截
启动时没报错但 curl 超时或连接被拒绝，大概率不是 Iris 问题，而是环境干扰：
-
:8080被其他进程占用了？用lsof -i :8080（macOS/Linux）或netstat -ano | findstr :8080（Windows）查 PID 并 kill - 某些 Linux 发行版（如 CentOS Stream）默认启用 firewalld，即使服务起来了，外部也访问不到——临时关掉：
sudo systemctl stop firewalld - GoLand 或 VS Code 的终端可能继承了旧 shell 环境变量（比如没加载
GO111MODULE），直接用系统终端跑更可靠
真正卡住的地方往往不是框架本身，而是 go mod 的隐式行为、网络代理残留、或系统级端口/防火墙策略——这些细节不报错，但会让第一个请求永远等不到响应。
