Gin默认不支持多模板引擎切换，因其HTMLRender仅绑定一个*template.Template实例；所谓“切换”需手动管理多个预编译模板集合，并通过自定义渲染函数按需调用，而非框架内置能力。
为什么 Gin 默认不支持“多模板引擎切换”
Gin 本身没有内置多模板引擎抽象层，HTMLRender 只绑定一个 *template.Template 实例。所谓“切换”，本质是手动管理多个预编译模板集合（比如一套 html/template、一套 text/template、甚至 pongo2 或 jet），并在 handler 中按需选择渲染器——不是框架能力，而是你控制流程的自由度。
如何在 Gin 中安全复用多个 html/template 实例
别试图给同一个 gin.Engine 注册多个 HTML 渲染器；Gin 的 SetHTMLTemplate() 是覆盖式设置。正确做法是：自己维护 map[string]*template.Template，并封装一个通用渲染函数。
-
template.Must(template.New("admin").Funcs(adminFuncMap).ParseFiles("templates/admin/*.html"))和template.Must(template.New("user").Funcs(userFuncMap).ParseFiles("templates/user/*.html"))分开初始化，存进map[string]*template.Template - handler 中根据路由或参数选模板：
t := templates["admin"]; t.Execute(w, data)，而不是调用c.HTML() - 必须确保每个
*template.Template的FuncMap在ParseFiles()前注册，否则出现function "xxx" not defined - 不同模板集之间
FuncMap不共享，不能靠 root 模板继承——{{template "sub" .}}跨集合会失败
混合使用 html/template 和 text/template 的坑
html/template 自动转义 HTML 特殊字符，text/template 不转义。若你在邮件模板里误用 html/template 渲染纯文本内容，<script> 会被变成 <script></script>，导致邮件内容异常。
- 定义两个独立变量：
htmlTmpl *template.Template和textTmpl *template.Template，不要混用 - 渲染时显式指定 writer 类型：
htmlTmpl.Execute(c.Writer, data)vstextTmpl.Execute(c.Writer, data) - 避免用
c.HTML()渲染非 HTML 内容——它内部硬编码了Content-Type: text/html; charset=utf-8 - 如果要返回 JSON 或 Markdown，别塞进模板引擎，直接用
c.JSON()或c.Data()
第三方模板引擎（如 pongo2、jet）接入 Gin 的关键约束
第三方引擎无法通过 SetHTMLTemplate() 接入，因为 Gin 的 HTMLRender 接口只接受 *template.Template。你必须绕过它，自己写响应逻辑。
立即学习“go语言免费学习笔记（深入）”；
- 用
pongo2.FromFile("tpl.html")加载，然后在 handler 中调用tpl.ExecuteWriter(...)直接写入c.Writer - 注意设置正确的
Content-Type：c.Header("Content-Type", "text/html; charset=utf-8") - 第三方引擎通常不支持
FuncMap注册时机校验，但可能有自己等价机制（如 pongo2 的RegisterFilter），务必查文档确认是否支持运行时注册 - 别在第三方模板函数里调用
c.Redirect()或修改c.Writer——模板必须无副作用
*template.Template 是线程安全的，但如果你在 FuncMap 函数里用了闭包捕获局部变量，或者用了全局计数器，那就会在高并发下出错——这不是 Gin 的问题，是模板函数写法错了。 
