Iris.Jet()注册失败或panic，主因是未导入github.com/CloudyKit/jet/v4包、./views目录不存在或权限不足、模板语法错误（如混用{{}}与{% %}）、或reload配置不当。
iris.Jet() 注册失败或 panic
调用 iris.Jet("./views", ".jet") 后程序直接 panic，大概率是 Jet 引擎未正确导入或版本不兼容。Jet 不是 Go 标准库，必须显式引入第三方包：github.com/CloudyKit/jet/v4（v4 是当前稳定版，v5 尚未被 Iris 官方适配）。
- 确保
go.mod中存在github.com/CloudyKit/jet/v4 v4.1.2或更高 v4.x 版本（Iris v12+ 要求 Jet v4） -
iris.Jet()返回的是view.Engine接口实现，但底层依赖jet.NewSet()初始化；若./views不存在或权限不足，会 panic 而非返回 error - Jet 模板文件必须以
.jet结尾（如index.jet），且目录路径需真实存在——不能是Views或views/（末尾斜杠会被忽略，但大小写敏感）
Jet 模板语法和 html/template 不兼容
Jet 的语法不是 {{}}，而是 {% %} 和 {{ }} 混用：控制结构用 {% if .user %}，变量输出用 {{ .name }}，这和 html/template 的纯 {{}} 完全不同。直接把 .html 文件改后缀为 .jet 不会生效，还可能因语法解析失败导致 ctx.View() 返回空响应或 500。
- Jet 默认不开启自动 HTML 转义，
{{ .raw_html }}会原样输出；如需转义，得用{{ .safe_html | safe }}或注册自定义 filter - Jet 支持 layout 继承：
{% extends "layout.jet" %}，但父模板中必须有{% block content %}{% endblock %}，子模板用{% block content %}...{% endblock %}填充——漏写block或拼错名字，渲染结果就是空白 - Jet 的
.上下文是传入的 data，但字段访问不支持链式调用（如{{ .user.profile.name }}），需提前展开为扁平结构或用with语句
ctx.ViewData 传参在 Jet 中失效
Jet 引擎对 ctx.ViewData() 的处理逻辑和 html/template 一致，但容易因作用域或调用时机出问题：如果在中间件里调了 ctx.ViewData("title", "Home")，而 handler 里又调了一次同 key 的 ctx.ViewData("title", "Admin")，后者会覆盖前者——Jet 不合并，只认最后一次。
- Jet 模板里访问
{{ .title }}时，该值必须是顶层字段；若你传的是map[string]interface{}{"data": map[string]string{"title": "Home"}}，就得写{{ .data.title }}，不能省略.data - Jet 对 nil 值更敏感：传入
nil结构体或未导出字段（首字母小写），渲染时直接 panic 报can't evaluate field XXX on nil，不像html/template那样静默跳过 - Jet 不支持
ctx.View("page.jet", data)这种 root binding 写法（即第二参数直接传 model），只能靠ctx.ViewData()或全局绑定；想传结构体，必须先ctx.ViewData("user", user)，再在模板里用{{ .user.Name }}
Jet Reload 不生效或修改后 404
Jet 默认不监听文件变更，tmpl.Reload(true) 必须在 app.RegisterView(tmpl) 之前调用才有效；但即使开了 reload，Windows 下仍常因文件系统通知延迟导致修改后首次请求 404 或旧内容。
- Jet 的 reload 是运行时重新 parse 模板字符串，不是热重载整个 set；如果模板里引用了不存在的 partial（如
{% include "header.jet" %}），reload 会失败并静默丢弃该模板，后续ctx.View("index.jet")就 404 - 开发阶段建议加一层兜底：用
tmpl.AddFunc("debug", func(s string) string { return "[JET] " + s })，在模板里调{{ debug "loaded" }}确认是否真加载成功 - 若用
go build && ./app启动，工作目录是执行命令的位置，不是二进制所在目录——./views得放在./app同级，否则 reload 找不到文件
Jet 的复杂度主要在语法隔离和错误反馈机制上：它不兼容 html/template 习惯，报错信息也不够友好，一个拼错的 {% endfor %} 可能导致整页空白而无日志。真要用 Jet，务必从最小可运行模板开始（仅 {{ "hello" }}），再逐步加逻辑，别一上来就套 layout + include + filter。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
