iris.HTML注册模板必须匹配实际文件结构，路径需与磁盘一致；分隔符须在RegisterView前用Delims设置；数据传递仅通过ctx.ViewData，热重载仅开发可用且依赖系统支持。
iris.HTML 是 Iris 框架里最常用的模板注册方式，但直接写 iris.HTML("./views", ".html") 就跑不起来——不是语法错，是路径、分隔符、重载逻辑没对齐。
模板路径注册必须匹配实际文件结构
Iris 不会自动递归扫描子目录，iris.HTML 第一个参数是「根目录」，它只认这个路径下的直接子文件，不处理嵌套层级。比如你把模板放在 ./views/admin/user.html，但注册的是 iris.HTML("./views", ".html")，那 ctx.View("admin/user.html") 会报 view not found。
- 正确做法：确保
ctx.View("admin/user.html")中的路径能被真实文件系统解析，即./views/admin/user.html必须存在 - 如果想支持多级目录，不用改注册逻辑，只需保证调用
ctx.View时传入的路径与磁盘路径一致即可 -
iris.Dir("./assets")用于静态资源，和模板路径无关，别混用
模板分隔符冲突必须显式覆盖
Vue、React 等前端框架默认用 {{}}，而 Go 标准库 html/template 默认是 {{}}，不改就会被服务端提前解析或报错。Iris 提供 Delims 方法解决，但很多人写了却没生效——因为必须在 RegisterView 之前调用。
- 错误顺序：
app.RegisterView(tmpl)→tmpl.Delims("${", "}")（无效） - 正确顺序：
tmpl.Delims("${", "}")→app.RegisterView(tmpl) - 分隔符不能含空格，
"${ "这类写法会导致解析失败
模板热重载只在开发环境有效，且依赖文件系统通知
tmpl.Reload(true) 看似开了热更新，但实际是否生效取决于 OS 的 inotify/watchdog 支持。Linux 通常没问题，macOS 上可能因 FSEvents 延迟导致修改后刷新不及时，Windows 则完全不可靠。
- 开发阶段建议开启，但别依赖它做“保存即刷新”的自动化流程
- 生产环境务必关闭：
tmpl.Reload(false)，否则每次请求都去检查文件修改时间，性能损耗明显 - 若发现修改模板后页面不变，先确认是否真被重新加载：加个
fmt.Println("template reloaded")在tmpl.Reload(true)后，看控制台有没有输出
传递数据必须用 ctx.ViewData，不能靠中间件隐式注入
有人试图在中间件里写 ctx.Set("title", "首页")，然后模板里直接 ${.title}，结果为空。Iris 的模板上下文是干净的，ctx.ViewData 才是唯一写入点，ctx.Set 存的是请求生命周期内的键值，不透传给模板引擎。
-
ctx.ViewData("user", user)→ 模板中${.user.Name}可访问 - 结构体字段必须首字母大写（导出），小写字段如
name string在模板里取不到 - 传递 map 或 slice 时，注意模板内循环语法：
{{range .items}}${.Name}{{end}}，别漏掉.items的点
Iris 模板机制本身轻量，但路径、分隔符、数据注入这三处最容易卡住人——它们都不报 panic，只是静默失败。调试时优先检查 ctx.View 调用前是否有对应文件、分隔符是否已设、ViewData 是否在渲染前调用。
