viewdata 必须在 ctx.view() 前设置才生效，否则模板变量为空；viewlayout 同理需提前调用；模板路径按 party 前缀自动推导，需确保视图目录结构匹配；所有 viewdata 设置须在 view 调用前完成。
ViewData 传值必须在 View() 调用前设置
直接调用 ctx.ViewData() 不会自动生效，它只是把键值对存进当前请求上下文的视图数据池里。真正触发渲染的是 ctx.View()，而该函数内部会读取这些数据并注入模板。如果顺序颠倒，比如先 ctx.View("index.html") 再 ctx.ViewData("Title", "Home")，那页面里 {{.Title}} 就是空字符串。
常见错误现象：{{.Title}} 渲染为空、模板中所有 .xxx 字段都未显示、浏览器源码里看到原始模板变量未被替换。
-
ctx.ViewLayout("layout.html")同样必须在ctx.View()前调用，否则 layout 不生效 - 多个
ctx.ViewData()可以连续调用，它们会合并到同一数据映射中 - 若需传递结构体或 map，直接传入即可：
ctx.ViewData("User", user)，模板中用{{.User.Name}}
控制器方法返回 string 或 mvc.Result 才能自动绑定视图
Iris MVC 的控制器方法如果返回 string（非指针）、error、mvc.Result 类型，框架会自动尝试渲染同名 HTML 模板。比如 Get() 方法返回 "hello"，默认找 get.html；返回 "admin/index"，就找 admin/index.html。
但这个行为依赖两个前提：一是你已通过 app.RegisterView(iris.HTML("./web/views", ".html")) 正确注册了视图引擎；二是模板路径必须可访问，且扩展名要和注册时一致（比如注册的是 ".html"，就不能放 .tmpl 文件）。
- 返回
string是最简方式，适合纯文本或简单 HTML 片段 - 返回
mvc.Response可精确控制状态码、Content-Type 和 body：return mvc.Response{Code: 200, ContentType: "text/html", Text: "OK"} - 若想跳过自动渲染，返回
nil并手动调用c.Ctx.View()，此时ViewData仍有效
使用 mvc.Application.Handle() 时，模板路径基于 Party 前缀自动推导
当你用 mvc.New(app.Party("/admin")) 创建 MVC 应用，再 Handle(new(AdminController))，那么 AdminController.Get() 返回 "dashboard"，Iris 会尝试加载 ./web/views/admin/dashboard.html，而不是根目录下的 dashboard.html。
这个路径推导规则容易被忽略，尤其当项目目录结构较深时。如果你的视图实际放在 ./web/views/ 下，但控制器绑定了 /api/v1 分组，框架就会去查 ./web/views/api/v1/xxx.html —— 这通常不存在，导致 404。
- 解决办法一：统一把所有视图放在
./web/views/根下，控制器返回带路径的字符串，如"user/list" - 解决办法二：注册视图时用绝对路径：
app.RegisterView(iris.HTML("./web/views", ".html"))，确保路径不随 Party 变化 - 不推荐硬编码完整路径到返回值里，比如
"./web/views/user.html"，这会绕过 Iris 视图引擎的查找逻辑
嵌套布局与 ViewData 作用域需显式管理
Iris 不支持模板继承语法（如 {{template "content" .}}），而是靠 ViewLayout + ViewData 组合实现类似效果。关键点在于：layout 模板里的 {{.Title}} 能否取到值，取决于 ViewData 是在 layout 渲染前还是后设置的 —— 而这由你调用 ctx.View() 的时机决定。
典型陷阱是，在 controller 方法里先 ctx.ViewData("Title", "User List")，再 ctx.ViewLayout("admin/layout.html")，最后 ctx.View("user/list.html")。这时 user/list.html 会被当作 content 注入 admin/layout.html，而 ViewData 对两者都可见。但如果在 user/list.html 内部又调用了 ctx.ViewData()，它不会影响外层 layout 的渲染，因为 layout 已经开始输出了。
- 所有
ViewData设置应在ctx.View()前完成，无论是否用了 layout - 若需不同页面有不同 layout，可在每个 handler 中单独调用
ctx.ViewLayout() - 避免在子模板（如 partials/header.html）里调用
ctx.ViewData()，它对父模板无效
