在go语言的text/template或html/template包中，有时我们需要在模板渲染过程中获取当前正在执行的模板的名称。虽然*template.template类型本身提供了name()方法来获取其名称，但这个方法通常在模板渲染的go代码侧调用。如果目标是在模板内部（例如，{{.somevalue}} 这样的表达式所在的上下文）直接访问模板名称，则需要一些额外的技巧。
理解 Template.Name() 方法
首先，我们需要明确*template.Template结构体上的Name()方法：
func (t *Template) Name() string
此方法返回模板的名称。例如，当你通过template.New("myTemplate")创建模板时，Name()将返回"myTemplate"。然而，这个方法是在Go代码中调用的，无法直接在模板语法{{...}}中访问。
核心方法：通过 template.FuncMap 注入函数
要在模板内部获取模板名称，最灵活且推荐的方法是利用template.FuncMap注册一个自定义函数。FuncMap允许你将Go函数映射到模板中可调用的名称。
实现步骤：
- 创建模板实例： 首先，使用template.New()创建一个*template.Template实例。这个实例的名称就是我们希望在模板内部获取的名称。
- 定义Go函数： 定义一个Go函数，该函数将返回上述模板实例的名称。这个函数需要捕获模板实例的引用。
- 注册到 FuncMap： 将这个Go函数包装成template.FuncMap，并使用t.Funcs()方法将其注册到模板实例上。
- 在模板中使用： 在模板文本中，通过注册时指定的名称调用这个函数。
下面是一个完整的示例，演示了如何使用template.FuncMap在模板内部获取模板名称：
package main
import (
"fmt"
"os"
"text/template"
)
func main() {
// 1. 定义模板内容，其中包含一个对 'templname' 函数的调用
const templateText = "当前模板名称: {{templname}} - 类型: {{.Thingtype}}\n"
// 2. 定义一个结构体，用于传递数据给模板
type Thing struct {
Thingtype string
}
// 3. 准备一些数据
var thingList = []*Thing{
{"Old"},
{"New"},
{"Red"},
{"Blue"},
}
// 4. 创建一个新的模板实例，并为其指定一个名称
// 注意：这里我们将模板命名为 "things"
t := template.New("things")
// 5. 定义一个Go函数，该函数返回模板实例 't' 的名称
// 这个函数通过闭包捕获了 't'
templateNameFunc := func() string {
return t.Name()
}
// 6. 将 'templateNameFunc' 注册到模板的 FuncMap 中，
// 并在模板中将其命名为 "templname"
// 随后解析模板内容
_, err := t.Funcs(template.FuncMap{"templname": templateNameFunc}).Parse(templateText)
if err != nil {
fmt.Println("解析模板失败:", err)
return
}
// 7. 遍历数据列表，并执行模板
for _, p := range thingList {
err := t.Execute(os.Stdout, p)
if err != nil {
fmt.Println("执行模板失败:", err)
}
}
}
输出结果：
当前模板名称: things - 类型: Old 当前模板名称: things - 类型: New 当前模板名称: things - 类型: Red 当前模板名称: things - 类型: Blue
代码解析：
- t := template.New("things")：我们创建了一个名为"things"的模板实例。
- templateNameFunc := func() string { return t.Name() }：我们定义了一个匿名函数templateNameFunc。由于这个函数是在main函数中定义的，它通过闭包捕获了外部变量t（即我们创建的模板实例）。当templateNameFunc被调用时，它会返回t.Name()的结果，也就是"things"。
- t.Funcs(template.FuncMap{"templname": templateNameFunc})：我们将templateNameFunc注册到模板t的FuncMap中，并为其指定了一个在模板内部可调用的名称"templname"。
- {{templname}}：在模板文本中，我们直接调用了"templname"函数，它将执行我们注册的templateNameFunc，并将其返回值（模板名称"things"）插入到输出中。
注意事项与最佳实践
- 注册时机： FuncMap必须在模板解析（Parse或ParseFiles）之前注册。如果先解析模板再注册函数，模板将无法识别这些函数。
- 闭包的利用： 上述方法巧妙地利用了Go语言的闭包特性，使得注册的函数能够访问到外部的模板实例t，从而获取其名称。
-
与直接传递数据对比：
- 直接传递数据： t.Execute(os.Stdout, struct{ Name string }{Name: t.Name()})。这种方式简单直接，适用于只需要在特定模板中获取名称的情况。
- FuncMap方法： 适用于需要将模板名称作为一种“内置”功能提供给所有（或一组）模板，或者当数据结构不易修改时。它提供了更大的灵活性，可以将任何Go函数注入到模板的执行环境中。
- 多层模板： 如果你使用template.ParseGlob或template.ParseFiles解析了多个模板，并且这些模板都属于同一个*template.Template实例（例如，通过t.ParseFiles(...)添加到t中），那么t.Name()通常返回的是最顶层或最先定义的模板名称。如果你需要获取当前正在执行的子模板（nested template）的名称，template.FuncMap方法可能需要更复杂的实现，例如，将当前执行的子模板实例作为参数传递给函数，或者通过某种上下文机制。然而，对于获取最初创建的*template.Template实例的名称，上述方法是有效的。
总结
通过template.FuncMap在Go模板内部动态获取当前模板名称是一种强大且灵活的技术。它允许我们将Go的逻辑无缝地集成到模板渲染过程中，而无需修改模板的数据结构。这种方法对于构建更具动态性和可重用性的模板系统非常有价值。
