本文主要解决在多租户场景下的模板渲染问题。

正常情况下 Gin 配置的所有模板都属于同一个模板组合，相同名称的模板将相互覆盖。在未通过 define 指定模板名称时，同名模板文件也将相互覆盖。自定义函数中也无法区分租户，这将非常不方便我们进行多租户的模板渲染处理。通过自定义 HTML 渲染器，将一一解决这些问题。

一、Gin 源码分析

Gin 通过 router.LoadHTMLGlob 或 router.LoadHTMLFiles 函数初始化 HTML 模板，这两个函数的源码如下。

// LoadHTMLGlob loads HTML files identified by glob pattern
// and associates the result with HTML renderer.
func (engine *Engine) LoadHTMLGlob(pattern string) {left := engine.delims.Leftright := engine.delims.Right// 初始化模板templ := template.Must(template.New("").Delims(left, right).Funcs(engine.FuncMap).ParseGlob(pattern))if IsDebugging() {debugPrintLoadTemplate(templ)engine.HTMLRender = render.HTMLDebug{Glob: pattern, FuncMap: engine.FuncMap, Delims: engine.delims}return}engine.SetHTMLTemplate(templ)
}// LoadHTMLFiles loads a slice of HTML files
// and associates the result with HTML renderer.
func (engine *Engine) LoadHTMLFiles(files ...string) {if IsDebugging() {engine.HTMLRender = render.HTMLDebug{Files: files, FuncMap: engine.FuncMap, Delims: engine.delims}return}// 初始化模板templ := template.Must(template.New("").Delims(engine.delims.Left, engine.delims.Right).Funcs(engine.FuncMap).ParseFiles(files...))engine.SetHTMLTemplate(templ)
}

可以看到，这里面区分了 DEBUG 模式，DEBUG 模式的渲染器是 render.HTMLDebug，他将在每次渲染是重新创建模板，从而使模板修改能够实时生效。

DEBUG 渲染器：

HTMLDebug 渲染器与生产渲染器没有本质不同，只是将创建 template 模板的步骤放在了执行渲染时。执行渲染的接口源码如下：

// Instance (HTMLDebug) returns an HTML instance which it realizes Render interface.
func (r HTMLDebug) Instance(name string, data any) Render {return HTML{// 重新创建模板Template: r.loadTemplate()