Controller需显式调用ctx.View()或返回mvc.Response{ContentType: "text/html"}，并提前注册视图引擎app.RegisterView(iris.HTML("./views", ".html"))；数据通过ctx.ViewData或mvc.Response.Data注入，Layout复用需配合ctx.ViewLayout()与模板中{{template "content" .}}。
Controller里怎么返回HTML模板而不是JSON
在Iris MVC中，Controller方法默认不自动渲染视图，必须显式调用ctx.View()或返回mvc.Result类型；直接return "string"或return struct{}会被转成JSON响应，不是HTML。
- 确保你的
Controller方法签名返回mvc.Result（推荐），或使用iris.Context参数手动调用ctx.View() - 模板路径是相对
views/目录的，比如ctx.View("user/profile.html")对应views/user/profile.html - 若用
mvc.Result，需返回mvc.Response并指定ContentType: "text/html"，否则Iris可能按application/json发送 - 模板引擎必须提前注册，例如
app.RegisterView(iris.HTML("./views", ".html"))，否则ctx.View()会panic
怎么向HTML模板传入动态数据
Iris MVC不提供类似Beego的this.Data全局绑定机制，所有数据必须通过ctx.ViewData或mvc.Response的LayoutData/Data字段注入。
- 在
Controller方法内：先调用ctx.ViewData("Title", "用户详情")，再调用ctx.View("user/detail.html") - 若用
mvc.Result方式，返回mvc.Response{Data: map[string]interface{}{"User": user, "ActiveTab": "profile"}} -
ViewData是请求级的，不会跨请求残留，但要注意它不支持嵌套结构体自动展开——必须传平铺的map或预序列化字段 - 模板中用
{{.Title}}或{{.User.Name}}访问，不能写{{.User.GetName}}（无反射调用方法能力）
为什么页面空白或报错“template not found”
常见原因不是路径写错，而是三个隐性前提没满足：视图引擎注册时机、模板文件编码、以及MVC路由组是否覆盖了views目录。
-
app.RegisterView(...)必须在mvc.New(app.Party(...))之前调用，否则ctx.View()找不到引擎 - 模板文件保存为UTF-8无BOM格式，Windows记事本默认带BOM，会导致解析失败且错误信息不提示BOM问题
- 如果
mvc.New(app.Party("/api"))，那它只处理/api/*下的路由，而ctx.View("home.html")仍会尝试加载，但静态文件服务没开——此时需确认你是否误把前端资源和后端视图混放 - 调试时加一行
app.Logger().Infof("view path: %s", ctx.Application().View().Dir())，确认Iris实际扫描的目录是否是你预期的./views
Layout布局怎么复用而不重复写header/footer
Iris支持Layout，但MVC下必须通过ctx.ViewLayout()或mvc.Response.Layout显式启用，它不会自动查找_layout.html。
- 在模板顶部声明
{{define "layout"}}{{template "content" .}}{{end}}，子模板用{{template "layout" .}}包裹内容 - 控制器中调用
ctx.ViewLayout("layouts/main.html")，再调用ctx.View("user/index.html") - 若用
mvc.Response，设置Layout: "layouts/main.html"，同时确保子模板里有{{define "content"}}区块 - 注意：
ViewLayout只对本次View生效，不会污染其他请求；但如果你在中间件里统一设了ctx.ViewLayout，要小心某些API接口误走HTML流程
app.RegisterView()是否真的执行了，以及ctx.Application().View().Dir()输出的路径是否正确。 
