直接用 iris.HTML 就够了，90% 的项目无需换引擎；它基于 Go 原生 html/template，稳定安全无额外依赖，而其他引擎存在学习成本高、维护弱或兼容性差等问题。
直接用 iris.HTML 就够了，90% 的项目不需要换引擎。
为什么标准 html/template 是首选
Go 原生的 html/template 稳定、安全、无额外依赖，Iris 的 iris.HTML 就是它的一层薄封装。其他引擎（如 pug、jet、django）要么语法学习成本高，要么 runtime 依赖多，要么社区维护弱——比如 iris.Pug() 底层用的是已归档的 Joker/jade，iris.Jet() 在 v12 中需手动适配新版本接口，容易出 template: xxx: no such template 错误。
常见错误现象：
- 切换引擎后
ctx.View("index.html")报错：路径没对上，因为不同引擎默认扫描扩展名不同（iris.Pug()扫.pug，iris.Jet()扫.jet） - 自定义函数（
AddFunc）在某些引擎里不生效，比如yield和render是 Iris 对html/template的扩展，其他引擎不支持
如何正确配置 iris.HTML
关键不是“选”，而是“配准”和“避坑”。三步必须做全：
-
tmpl := iris.HTML("./views", ".html")—— 路径必须是相对项目根目录的，不是相对于main.go -
tmpl.Delims("${", "}")—— 强烈建议改分隔符，否则和 Vue/React 模板冲突，浏览器会把{{.Name}}当成未解析的前端占位符显示出来 -
tmpl.Reload(true)—— 开发期必开，否则改了模板要重启服务；上线时关掉（false），避免每次请求都检查文件修改时间，影响性能
示例片段：
app := iris.New()
tmpl := iris.HTML("./views", ".html")
tmpl.Delims("${", "}")
tmpl.Reload(iris.IsDevelopment) // 自动判断环境
app.RegisterView(tmpl)
布局复用（Layout）怎么实现
Iris 的 html/template 支持原生 template 动作，但 Layout 不是自动的，得靠约定+显式调用：
- 在
./views/layout.html里定义主框架，用{{template "content" .}}预留内容区 - 每个子页（如
./views/home.html）开头写{{define "content"}}...{{end}} - 渲染时仍调用
ctx.View("home.html")，Iris 会自动识别并组合——前提是子页用了define，且 layout 已被加载（Iris 会递归扫描所有.html文件）
容易踩的坑：
- 子页忘了写
{{define "content"}}，页面就只显示 layout 的静态部分，内容为空 - layout 文件名不是
layout.html或没放在 views 根目录，Iris 不会自动识别，得手动tmpl.AddTemplate("layout", "...") - 使用
{{yield}}函数？别试——那是旧版 Iris 的遗留语法，v12 已移除，强行用会 panic
什么时候该考虑换引擎
只有两个真实场景值得切：
- 团队已重度使用 Pug/Jinja2，且有现成组件库要复用，此时选
iris.Pug()或iris.Django()可降低迁移成本 - 需要服务端组件化（比如带参数的可复用 partial 模板），而
html/template的template动作太简陋，这时iris.Jet()的{{include "header" .}}更直观
但注意：iris.Jet() 默认不支持 yield/render 这类 Iris 扩展函数，得自己 AddFunc 注册，且热重载逻辑要重写——它的 Reload 接口和 iris.HTML 不兼容。
最常被忽略的一点：模板引擎选型一旦落地，就很难回退。因为 ctx.ViewData 绑定方式、嵌套语法、错误提示格式全都不一样，调试成本远高于初期多花十分钟配好 iris.HTML。
