Iris.New()后必须调用Listen()或Run()启动服务器，否则服务不运行；路径参数用ctx.Params().Get()而非ctx.URLParam()；中间件中写响应后须调用ctx.StopExecution()且避免后续ctx.Next()；模板路径需用iris.Dir()注册并匹配实际文件结构。
iris.New() 之后必须显式调用 Listen() 或 ConfigureHost()
很多人写完 iris.New() 就直接写路由，结果服务压根没起来，浏览器访问 8080 没反应——不是代码错了，是根本没启动 HTTP server。Iris 不像某些框架会自动监听，默认只是初始化一个应用实例。
常见错误现象：go run main.go 后终端无报错、无日志、进程不阻塞（立刻退出）或阻塞但无法响应请求。
- 正确做法：在
iris.New()后加.Listen(":8080")（开发常用）或.Run(iris.Addr(":8080"))（v12+ 推荐） -
Listen()是旧版惯用法；Run()更灵活，支持传入iris.Configuration控制超时、TLS 等 - 如果用了
iris.TLS()或自定义http.Server，必须用ConfigureHost()，否则 TLS 配置不生效
路由参数绑定用 ctx.Params().Get("name")，别用 ctx.URLParam()
ctx.URLParam() 是解析 URL 查询参数（?id=123），不是路径参数（/user/123）。新手常在这儿混淆，导致取不到 ID、返回空字符串。
使用场景：RESTful 路由如 app.Get("/user/{id:uint64}", handler)，想拿到 123 这个值。
立即学习“go语言免费学习笔记（深入）”；
- 路径参数统一走
ctx.Params()：用ctx.Params().Get("id")或带类型转换的ctx.Params().GetInt64("id") -
ctx.URLParam()只处理 query string，比如/search?keyword=go→ctx.URLParam("keyword") - 如果参数名拼错（如写成
"ID"但路由定义是{id}），Get()返回空字符串，不会 panic —— 容易漏掉校验
中间件里调用 ctx.Next() 前不能 ctx.StopExecution() 或已写响应
中间件逻辑里一旦调用了 ctx.StopExecution()、ctx.StatusCode() + ctx.WriteString()，后续中间件和最终 handler 就不会再执行。但如果忘了这点，还在后面写 ctx.Next()，程序不会报错，但行为不可预期（比如日志中间件重复打印、鉴权失败后仍进业务逻辑）。
典型踩坑场景：JWT 验证中间件里解析 token 失败，直接 ctx.JSON(401, ...)，但末尾又写了 ctx.Next()。
- 正确模式：验证失败 → 写响应 +
ctx.StopExecution()，且确保ctx.Next()在if分支之外不被执行 -
ctx.Next()的作用是“把控制权交给下一个中间件或 handler”，它本身不阻止后续代码运行 —— 所以靠条件控制执行流更安全 - Iris 不检查是否已写响应就调
Next()，这跟 Gin 的abort()语义不同，得自己盯住
模板渲染用 ctx.View() 时，目录路径必须用 iris.Dir() 注册且区分开发/生产
本地跑得好好的模板，部署到服务器就报 template: "index.html" not found，大概率是视图路径没对上。Iris 默认不自动扫描子目录，也不接受相对路径字符串。
性能影响：每次 ctx.View() 都会查缓存，但如果 iris.Dir() 指向错误路径，就会反复失败并触发 fallback 逻辑，拖慢首屏。
- 注册方式必须是
app.RegisterView(iris.HTML("./views", ".html").Binary(Asset, AssetNames))，其中./views是相对于os.Executable()的路径，不是os.Getwd() - 开发时建议用
Binary()配合go:embed打包模板，避免线上漏传文件；生产环境禁用Reload(true) - 模板名传给
ctx.View()时不带扩展名（如ctx.View("index")），但iris.HTML()初始化时指定的后缀必须匹配实际文件
