引言
在使用 go 语言的 text/template 或 html/template 包构建动态内容时，有时需要在模板执行过程中获取当前模板自身的名称。虽然 *template 类型提供了 name() 方法来获取模板的名称，但这个方法是在 go 代码层面操作 *template 对象时使用的，无法直接在模板语法 {{...}} 内部调用。本文将详细介绍如何通过 template.funcmap 机制，实现在模板内部动态获取当前模板名称的功能。
理解 *Template.Name() 方法
Go 语言的 text/template 包中的 *Template 类型提供了一个 Name() 方法，其签名如下：
func (t *Template) Name() string
此方法返回模板的名称。例如，如果你通过 template.New("myTemplate").Parse(...) 创建了一个模板，那么 myTemplate.Name() 将返回字符串 "myTemplate"。然而，这个方法是 Go 程序在处理模板对象时调用的，不能直接在模板文件（例如 .html 或 .txt 文件）的语法中像 {{.Name}} 或 {{.t.Name}} 这样使用，因为模板上下文 (.) 通常绑定到传入的数据结构，而不是模板对象本身。
通过 template.FuncMap 在模板内部获取名称
要在模板内部访问模板名称，最优雅且推荐的方法是利用 template.FuncMap 注册一个自定义函数。FuncMap 允许你将 Go 函数暴露给模板，使其可以在模板中被调用。
1. 定义一个辅助函数
首先，我们需要在 Go 代码中定义一个函数，该函数能够返回当前模板的名称。这个函数需要能够访问到 *Template 对象。
// 假设 t 是你的 *template.Template 实例
templateNameFunc := func() string {
return t.Name()
}请注意，templateNameFunc 是一个闭包，它捕获了外部 t 变量，确保在函数被调用时能获取到正确的模板实例名称。
2. 将函数注册到 FuncMap
在解析或执行模板之前，你需要将这个辅助函数添加到 template.FuncMap 中，并将其关联到一个模板内部可以调用的名称（例如 templname）。
t := template.New("things") // 创建模板实例
templateName := func() string { return t.Name() } // 定义辅助函数
// 将函数注册到 FuncMap
template.Must(t.Funcs(template.FuncMap{"templname": templateName}).Parse(text))3. 在模板中使用自定义函数
一旦函数被注册，你就可以在模板内容中直接调用它，就像调用内置函数一样。
const text = "{{.Thingtype}} {{templname}}\n" // 在模板中调用 templname完整示例代码
以下是一个完整的可运行示例，演示了如何在 Go text/template 中使用 template.FuncMap 来获取模板名称：
package main
import (
"fmt"
"os"
"text/template"
)
func main() {
// 模板内容，其中 {{templname}} 将会调用我们注册的函数
const tplContent = "{{.Thingtype}} {{templname}}\n"
// 定义用于模板的数据结构
type Thing struct {
Thingtype string
}
// 示例数据
var thinglist = []*Thing{
{"Old"},
{"New"},
{"Red"},
{"Blue"},
}
// 1. 创建一个新的模板实例，并为其指定一个名称
// 这个名称 "things" 就是我们希望在模板内部获取的名称
t := template.New("things")
// 2. 定义一个辅助函数，该函数返回模板实例的名称
// 注意：这个函数是一个闭包，它捕获了变量 t
templateNameGetter := func() string {
return t.Name()
}
// 3. 将辅助函数注册到 FuncMap
// "templname" 是模板中用来调用此函数的名称
// template.Must 用于简化错误处理，如果解析失败会 panic
template.Must(t.Funcs(template.FuncMap{"templname": templateNameGetter}).Parse(tplContent))
// 4. 遍历数据并执行模板
for _, p := range thinglist {
err := t.Execute(os.Stdout, p)
if err != nil {
fmt.Println("执行模板错误:", err)
}
}
}输出：
Old things New things Red things Blue things
从输出可以看出，{{templname}} 成功地被替换成了模板实例的名称 "things"。
替代方案：将名称作为数据传递
除了使用 template.FuncMap，另一种更直接但可能不够灵活的方法是，在执行模板时将模板名称作为数据结构的一部分传递进去。
package main
import (
"fmt"
"os"
"text/template"
)
func main() {
const tplContent = "{{.Thingtype}} {{.TemplateName}}\n"
type ThingWithTemplateName struct {
Thingtype string
TemplateName string // 新增字段用于传递模板名称
}
t := template.New("items") // 模板名称为 "items"
// 解析模板
template.Must(t.Parse(tplContent))
// 准备数据，并将模板名称显式地添加到数据中
thinglist := []*ThingWithTemplateName{
{"Old", t.Name()},
{"New", t.Name()},
}
for _, p := range thinglist {
err := t.Execute(os.Stdout, p)
if err != nil {
fmt.Println("执行模板错误:", err)
}
}
}输出：
Old items New items
这种方法的优点是简单直观，不需要额外的 FuncMap 设置。缺点是模板名称必须手动添加到每个数据对象中，如果数据结构复杂或模板名称需要动态变化，可能会比较繁琐。
总结与注意事项
-
template.FuncMap 方法：
- 优点：更具通用性，一旦注册，模板内部可以随时调用，无需修改数据结构。适用于模板名称在 Go 代码中确定，并在多个数据项中保持一致的场景。
- 缺点：需要额外设置 FuncMap。
-
将名称作为数据传递方法：
- 优点：实现简单直接，易于理解。
- 缺点：需要修改数据结构以包含模板名称字段，如果模板名称需要根据不同数据项而变化，可能需要更复杂的逻辑来填充数据。
在大多数需要从模板内部获取模板名称的场景中，使用 template.FuncMap 注册自定义函数是更推荐和更灵活的做法，因为它将模板名称的获取逻辑封装在 Go 代码中，使得模板本身更专注于内容的渲染，而不是数据准备。
