项目初始化失败主因是go mod未正确初始化或未调用app.listen()/run()；go mod init须在根目录执行且模块名小写无空格；iris.new()后必须显式启动服务；路径参数用ctx.params()、查询参数用ctx.urlparam()；配置加载须在iris.new()前完成。
项目初始化失败，八成是 go mod 没跑对，或者 iris.New() 后忘了 app.Listen() 或 app.Run() —— 这两个动作缺一不可，否则进程静默退出，连监听端口这一步都没发生。
go mod init 必须在项目根目录执行，且模块名不能含空格或大写
很多人卡在第一步：执行 go run main.go 报 undefined: iris 或 cannot find package "github.com/kataras/iris/v12"。这不是 Iris 没装，而是 Go 根本没把当前目录识别为 module 项目。
- 进空文件夹，运行
go mod init myapp（名称必须小写、无下划线、无空格） - 立刻跟一句
go get github.com/kataras/iris/v12@latest，明确指定 v12 版本 - 检查生成的
go.mod文件里是否有类似github.com/kataras/iris/v12 v12.2.11的行；没有就重试，别跳过 - 别用
go get github.com/kataras/iris（不带/v12），那会拉 v11 兼容版，类型系统不兼容
iris.New() 后必须显式启动服务，Listen() 和 Run() 不可省略
iris.New() 只是创建一个空的 *iris.Application 实例，它不会自动监听端口、也不会阻塞主线程。你看到终端“没反应”，大概率是程序执行完就退出了。
- 开发阶段直接用
app.Listen(":8080")，简洁够用 - 生产环境推荐
app.Run(iris.Addr(":8080"))，它支持传入iris.Configuration控制超时、TLS 等行为 - 如果用了
iris.TLS()或自定义http.Server，必须用app.ConfigureHost()，否则配置不生效 - 错误现象：终端一闪而过、
curl localhost:8080连接被拒绝、netstat -tuln | grep 8080查不到监听 —— 全是没调启动函数的典型表现
路由参数取值别混淆 ctx.Params() 和 ctx.URLParam()
刚初始化完项目写第一个接口，常因参数取错导致返回空值却查不出原因。Iris 对路径参数（path param）和查询参数（query param）做了严格分离，不能混用。
- RESTful 路由如
app.Get("/user/{id:uint64}", handler)，ID 是路径段的一部分 → 用ctx.Params().Get("id")或ctx.Params().GetInt64("id") - URL 查询如
/search?keyword=go&page=2→ 用ctx.URLParam("keyword")和ctx.URLParam("page") - 拼错参数名（比如路由写
{id}却调ctx.Params().Get("ID")）会静默返回空字符串，不 panic，容易漏掉校验 - 想强制校验存在性，用
ctx.Params().GetString("id", "default")或配合if id := ctx.Params().Get("id"); id == "" { ... }
真正容易被忽略的是：配置加载必须在 iris.New() 之前完成。Viper、环境变量、flag 解析这些事，得在创建 Application 实例前干完——因为 handler 里要依赖的业务参数（比如数据库地址、密钥），不是靠框架注入的，是你自己塞进去的。晚一步，handler 就拿不到值。
