在Go语言的Web开发或者文本生成场景中，经常需要使用html/template或者text/template包来渲染动态内容。有时候我们会遇到这样的需求：后端传递一个用逗号分隔的字符串到模板，需要在模板中把它拆分成多个部分再逐个展示，这时候就需要用到FuncMap来扩展模板的能力。
什么是FuncMap
FuncMap是Go Template提供的一个映射类型，它的作用是把自定义的函数注册到模板中，让这些函数可以在模板文件里直接调用。FuncMap的本质是map[string]interface{}，键是函数在模板中的名称，值是对应的Go函数。
需要注意的是，注册到FuncMap的函数需要满足几个要求：
- 函数的参数和返回值数量没有严格限制，但是不能有可变参数
- 如果返回值有error类型，那么当函数执行出错时，模板渲染会返回错误
- 函数必须是公开的，或者是在同一个包内可访问的
实现字符串分割的自定义函数
Go语言标准库的strings包已经提供了strings.Split函数，我们可以直接把这个函数包装后注册到FuncMap中，不过需要注意strings.Split的返回值是一个字符串切片，模板可以直接循环处理切片，所以不需要额外包装，直接注册即可。
首先我们看一个简单的示例，先定义需要注册的分割函数，这里我们可以直接使用strings.Split：
package main
import (
"html/template"
"net/http"
"strings"
)
// 定义FuncMap，注册split函数
var funcMap = template.FuncMap{
// 模板中使用的函数名是split，对应的值是strings.Split函数
"split": strings.Split,
}
// 处理请求的处理器函数
func handler(w http.ResponseWriter, r *http.Request) {
// 解析模板，同时传入FuncMap
tmpl, err := template.New("test.tmpl").Funcs(funcMap).ParseFiles("test.tmpl")
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
// 准备传递给模板的数据，tags是用逗号分隔的字符串
data := map[string]string{
"Tags": "go,template,funcmap,split",
}
// 渲染模板
err = tmpl.Execute(w, data)
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
}
}
模板文件中使用分割函数
对应的模板文件test.tmpl内容如下，我们在模板中调用注册的split函数，对Tags字段进行分割，然后循环展示每个标签：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>字符串分割示例</title>
</head>
<body>
<h3>标签列表：</h3>
<ul>
{{range split .Tags ","}}
<li>{{.}}</li>
{{end}}
</ul>
</body>
</html>
上面的模板中，{{split .Tags ","}}就是调用我们注册的split函数，第一个参数是传入的Tags字符串，第二个参数是分隔符逗号，函数返回的是字符串切片，然后用{{range}}指令循环切片，输出每个元素。
注意事项
FuncMap的注册时机
FuncMap必须在模板解析之前注册，也就是要先调用Funcs方法再调用Parse或者ParseFiles方法，否则模板解析的时候找不到对应的函数会报错。如果是先解析模板再注册函数，会导致函数无法被模板识别。
函数参数匹配
注册的函数参数数量和调用时传入的参数数量必须一致，比如strings.Split需要两个参数，分别是待分割的字符串和分隔符，那么在模板中调用的时候就必须传入两个参数，少传或者多传都会导致渲染错误。
处理空值情况
如果传入的字符串是空值，strings.Split会返回一个包含一个空字符串的切片，这时候循环会输出一个空的列表项，如果需要避免这种情况，可以在注册函数的时候做一层判断，比如自定义一个安全的分割函数：
func safeSplit(str, sep string) []string {
if str == "" {
return []string{}
}
return strings.Split(str, sep)
}
// 注册的时候使用safeSplit
var funcMap = template.FuncMap{
"split": safeSplit,
}
总结
通过FuncMap自定义模板函数是Go Template扩展功能的核心方式，实现模板内字符串分割只需要把strings.Split或者自定义的分割函数注册到FuncMap中，就可以在模板里直接调用。使用时注意注册时机、参数匹配以及边界情况的处理，就能顺利实现模板内的字符串分割需求，让模板处理逻辑更加灵活。
Go_TemplateFunMap字符串分割模板函数修改时间：2026-07-08 09:30:31