go get 命令本身几秒完成，但真正卡住新手的是环境配置、依赖冲突和版本错配三关；需清理 go.mod/go.sum、指定稳定版 iris/v12、正确导入路径、检查监听错误、生产禁用 CGO 并验证基础运行。
go get 命令本身几秒就完成，但“安装完成”不等于“能跑起来”——真正卡住小白的，是环境、依赖和版本错配这三关。别被“一行命令安装”误导，实际部署耗时主要花在排查 go mod 冲突、CGO_ENABLED 报错、或 iris.Run 启动失败上。
go get 失败常见于 GOPROXY 或版本锁定冲突
执行 go get github.com/kataras/iris/v12@latest 报错“unknown revision”或“no matching versions”？不是网络问题，大概率是本地 go.mod 里已有其他依赖锁定了旧版 golang.org/x/net 等间接依赖。
实操建议：
• 先删掉项目根目录的 go.mod 和 go.sum
• 运行 go mod init myapp 初始化干净模块
• 再执行 go get github.com/kataras/iris/v12@v12.2.0（推荐指定已知稳定小版本，而非 @latest）
• 如果仍报错，临时设代理：export GOPROXY=https://goproxy.cn,direct
运行时报 undefined: iris.New 或 Assets 错误
这类错误说明导入路径或包结构不匹配，Iris v12 要求显式使用 v12 子路径，且不能混用旧版导入方式。
常见错误现象：
• undefined: iris.New：代码里写了 import "github.com/kataras/iris"（缺 /v12）
• Assets undefined：用了模板功能但没导入 github.com/kataras/iris/v12/view 或漏调 app.RegisterView
实操建议：
• 所有导入必须带 /v12，例如：import "github.com/kataras/iris/v12"
• 检查 go list -m all | grep iris 输出是否只有一行 github.com/kataras/iris/v12 v12.x.x
• 若用模板，确保调用 app.RegisterView(iris.HTML("./templates", ".html"))
启动后访问 404 或连接被拒绝
不是 Iris 没装好，而是监听配置或端口权限出了问题。本地开发常忽略 Listen 的返回值和错误处理。
使用场景：
• Windows 上监听 :80 会因权限被拒而静默失败
• Linux 上 :8080 被占用时，app.Listen 不报错但进程退出
实操建议：
• 总是检查 app.Listen 返回的 error：if err := app.Listen(":8080"); err != nil { panic(err) }
• 开发阶段优先用非特权端口（如 :8080、:3000）
• 启动后立刻用 curl -v http://localhost:8080 验证，别只看终端有没有 panic
编译部署到服务器前必须关掉 CGO
本地 go run main.go 能跑，不代表编译出的二进制能在服务器运行——尤其当目标机是 Alpine Linux 或最小化 CentOS 时，CGO_ENABLED=1 会链接系统 libc，极易出现 cannot execute binary file: Exec format error 或 DNS 解析失败。
参数差异：
• CGO_ENABLED=0：完全静态链接，无外部依赖，但禁用 SQLite、系统 DNS 解析（用 net.Resolver 会 fallback 到慢路径）
• CGO_ENABLED=1：需目标机有对应 libc 版本，适合内网可控环境
实操建议：
• 生产部署一律用：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp ./main.go
• 若必须用 Redis 或自定义 DNS，请在服务器上装好 glibc 并测试 ldd ./myapp 输出是否干净
真正的瓶颈不在“安装”，而在确认 go version ≥ 1.19、GO111MODULE=on、以及第一次 go build 成功后能否 curl 通——这三个点卡住 80% 的新手。别跳过验证步骤，哪怕只是多敲一次 curl。
