必须显式调用iris.HTML("./views", ".html")注册模板引擎，路径相对于运行目录，后缀须与文件一致；需配tmpl.Reload(true)和tmpl.Delims("${","}")增强调试；ViewData必须在View前调用且同handler内；静态资源须单独用app.HandleDir挂载；重定向后必须return防止重复响应。
如何用 iris.HTML 注册模板引擎
服务端渲染的前提是 Iris 能找到并正确解析 HTML 模板文件。必须显式调用 iris.HTML 并传入路径和后缀，否则 ctx.View() 会 panic 或静默失败。
常见错误现象：访问页面返回 500、空响应或 “template not found” 错误，但控制台无明确提示。
-
iris.HTML("./views", ".html")中的路径是相对于go run当前工作目录，不是源码目录 —— 如果用go build && ./app运行，需确保./views在二进制同级目录 - 后缀必须与实际文件名一致：
index.html对应".html"，不能写成".htm"或漏掉点 - 推荐加两行增强调试能力：
tmpl.Reload(true)（开发时热重载）、tmpl.Delims("${", "}")（避免和 Vue/React 的{{}}冲突）
ctx.ViewData 和 ctx.View 的调用顺序不能颠倒
ctx.ViewData("key", value) 是把数据注入到当前请求上下文的模板作用域里，它本身不触发渲染；真正触发 HTML 渲染的是 ctx.View("name.html")。两者必须在同一 handler 内配对使用，且 ViewData 必须在 View 之前。
典型翻车场景：在中间件里调 ViewData，主 handler 却没再调一次 —— 数据不会跨 handler 自动继承。
- 正确写法：
c.ViewData("title", "首页"); c.View("home.html") - 错误写法：先
c.View("home.html")再c.ViewData(...)→ 模板已渲染完毕，数据被丢弃 - 如果需要全局共享数据（如用户登录态），应改用
c.Session().Set()+ 模板内通过自定义函数读取，而非依赖ViewData
静态资源必须用 app.HandleDir 单独挂载
Iris 不会自动托管 ./views 下的 CSS/JS 图片 —— 它只管模板渲染。前端资源全部 404？大概率是忘了配静态路由。
路径映射容易错：浏览器请求 /assets/css/app.css，对应磁盘路径是 ./assets/css/app.css，但 HandleDir 第一个参数是 URL 前缀，第二个才是磁盘路径。
- 正确：
app.HandleDir("/assets", iris.Dir("./assets")) - 错误：
app.HandleDir("/assets", iris.Dir("./views/assets"))（除非你真把静态文件放 views 里） - 注意权限：Linux 下如果
./assets目录不可读，Iris 不报错，但返回 403 —— 用ls -l ./assets确认
跳转后立即 return，否则模板可能重复执行
服务端渲染常配合登录态校验做重定向，比如未登录就跳 /login。但 c.Redirect() 只发 HTTP 头，不终止 Go 函数执行 —— 后续 c.View() 仍会跑，导致 “http: multiple response.WriteHeader calls” panic。
这个坑在 MVC Controller 里更隐蔽，因为方法体长，容易忽略末尾是否 return。
- 必须写：
c.Redirect("/login"); return - 严禁写：
c.Redirect("/login")后还跟着c.View("dashboard.html") - Controller 内要用
c.Ctx.Redirect()，不是c.Redirect()（后者不存在）
最易被忽略的一点：Iris 的服务端渲染本质仍是「每次请求生成一份 HTML」，它不自动缓存渲染结果。高并发下模板解析可能成瓶颈，真要上生产，得自己加一层 Redis 缓存 HTML 片段，或改用预渲染（prerender）方案。
