模板引擎注册不必须用iris.HTML()，但推荐使用；它基于html/template，安全且零依赖；其他引擎需额外引入包并注意编译依赖；ViewData与View传参机制不同，变量名冲突时需注意作用域；结构体字段须大写首字母；模板渲染失败常见于数据未传入、路径错误或后缀不匹配；与Vue冲突可改Delims，但需同步前端配置并开启Reload。
模板引擎注册必须用 iris.HTML() 吗？
不是必须，但绝大多数场景下推荐用 iris.HTML()。它底层调用 Go 标准库的 html/template，零依赖、安全（自动 HTML 转义）、文档成熟。其他引擎如 iris.Django() 或 iris.Jet() 需额外引入包，且部分函数（比如 yield、render）只在特定引擎中支持。
常见错误是直接写 iris.New().RegisterView(iris.Django(...)) 却没加 go get github.com/kataras/iris/v12/iris-contrib/pongo2，导致编译失败报 undefined: iris.Django。
如果你只是渲染简单页面、配合 Vue/React 做前后端分离，html/template 完全够用，别为“高级语法”提前切换引擎。
ctx.ViewData() 和 ctx.View("xxx.html", data) 传参方式怎么选？
二者本质不同：ctx.ViewData() 是键值对绑定到上下文，供所有后续模板访问；ctx.View("xxx.html", data) 是单次传入结构体或 map，仅作用于当前模板根对象。
容易踩的坑：
- 混用时变量名冲突：比如先
ctx.ViewData("user", u1)，再ctx.View("profile.html", u2)，模板里写{{.user.Name}}会取到u1，但{{.Name}}会取到u2—— 不是覆盖，是并存 - 结构体字段必须首字母大写，否则
html/template无法反射访问（{{.name}}永远为空） - 传指针更安全：若结构体较大，
ctx.View("page.html", &data)避免拷贝开销
为什么模板里写 {{.message}} 渲染不出来？
最常见三个原因：
- 没调用
ctx.ViewData("message", "xxx")，或调用位置在ctx.View()之后（顺序错） - 模板文件后缀不匹配：注册时用
iris.HTML("./views", ".htm")，但实际文件是test.html→ 找不到模板 - 路径错误：模板注册的目录是
"./views"，但代码运行时工作目录不在项目根目录（比如用go run cmd/main.go时，当前路径是cmd/）→ 改成绝对路径或用filepath.Join(os.Getenv("PWD"), "views")
调试建议：在路由 handler 里加一行 ctx.Application().Logger().Infof("view data: %+v", ctx.Values().Get("viewData")) 看数据是否真传进去了。
和 Vue 冲突怎么办？Vue 用 {{}}，模板也用 {{}}
Iris 默认用 {{}}，但可以换 Delims：
tmpl := iris.HTML("./views", ".html")
tmpl.Delims("${", "}") // 改成 ${.message}
app.RegisterView(tmpl)
注意两点：
-
Delims()必须在RegisterView()之前调用，否则无效 - 改完后所有模板都要同步改成
${.xxx}，不能混用；如果部分页面纯服务端渲染、部分要给 Vue 用，建议统一用${}，前端 Vue 实例初始化时设delimiters: ["${", "}"]
真正难处理的不是语法冲突，而是缓存——tmpl.Reload(true) 开发期必须开，否则改了模板不生效，你会以为是 Delims 没生效，其实只是旧模板还卡在内存里。
