本文介绍如何通过 template.FuncMap 向 Go 的 html/template 注册自定义函数（如将标题转换为 URL 友好的 slug 格式），并在模板中使用管道语法 | 调用，实现如 "the quick brown fox" → "the-quick-brown-fox" 的实时转换。
本文介绍如何通过 template.funcmap 向 go 的 html/template 注册自定义函数（如将标题转换为 url 友好的 slug 格式），并在模板中使用管道语法 | 调用，实现如 "the quick brown fox" → "the-quick-brown-fox" 的实时转换。
在 Go Web 开发中，HTML 模板默认仅支持有限的内置函数（如 printf、html、urlquery），若需对数据进行特定格式化（例如生成 URL slug、去除空格、添加连字符等），必须显式注册自定义函数。核心方法是使用 template.FuncMap 将 Go 函数映射为模板可调用的命名函数。
首先，编写一个符合签名 func(string) string 的处理函数。以下是一个完整的 slug 生成函数示例，支持空格替换、非字母数字字符清理及小写转换：
import (
"strings"
"unicode"
"text/template"
)
// Sluggify 将字符串转换为 URL 安全的 slug：只保留字母、数字和连字符，空格转为 '-'，并转为小写
func Sluggify(s string) string {
var b strings.Builder
prevIsDash := false
for _, r := range s {
switch {
case unicode.IsLetter(r) || unicode.IsDigit(r):
b.WriteRune(unicode.ToLower(r))
prevIsDash = false
case unicode.IsSpace(r) || r == '_' || r == '.':
if !prevIsDash {
b.WriteRune('-')
prevIsDash = true
}
default:
// 忽略其他特殊字符（如 @, #, ? 等）
prevIsDash = false
}
}
// 去除首尾可能的连字符
result := strings.Trim(b.String(), "-")
return result
}接着，在初始化模板时，通过 Funcs() 方法注入该函数：
funcMap := template.FuncMap{
"slug": Sluggify, // 模板中将用 {{.Title | slug}} 调用
}
t := template.Must(template.New("edit").Funcs(funcMap).Parse(`
<h1>Editing {{.Title}}</h1>
<form action="/save/{{.Title | slug}}" method="POST">
<div><input name="title" type="text" placeholder="title" value="{{.Title}}"></div>
<div><textarea name="body" rows="20" cols="80">{{.Body}}</textarea></div>
<div><input type="submit" value="Save"></div>
</form>
`))⚠️ 关键注意事项：
立即学习“前端免费学习笔记（深入）”；
- 自定义函数必须是导出函数（首字母大写），且参数与返回值类型需明确（推荐
string → string）； - 模板中调用时必须使用
|管道语法（{{.Title | slug}}），不可写作{{slug .Title}}（除非函数接受interface{}并做类型断言）； - 若函数可能 panic（如未处理 nil 输入），建议在函数内部加防御性检查，或配合
template.HTMLEscapeString等安全函数使用； -
FuncMap需在Parse()之前调用，否则函数不可用。
最终效果：当 .Title 为 "The Quick Brown Fox!" 时，{{.Title | slug}} 渲染为 "the-quick-brown-fox"，完美适配 /save/ 路由路径。此方案简洁、可复用，是 Go 模板扩展数据处理能力的标准实践。
