当前位置：首页 > Go > 正文

Go语言模板进阶指南（手把手教你注册自定义函数到html/template）

主机测评网
Go
2025-12-09
974

在使用 Go 语言开发 Web 应用时，Go语言模板（html/template 包）是渲染 HTML 页面的核心工具。但有时候，模板内置的函数无法满足我们的需求，比如格式化时间、处理字符串、计算数值等。这时，我们就需要使用 自定义函数 来扩展模板的能力。

本文将从零开始，详细讲解如何在 Go 模板中注册和使用 Go模板函数，即使是编程新手也能轻松上手！

Go语言模板进阶指南（手把手教你注册自定义函数到html/template） Go语言模板自定义函数 Go模板函数 template.FuncMap 第1张

什么是 template.FuncMap？

template.FuncMap 是 Go 语言中用于定义模板函数映射的类型。它本质上是一个 map[string]interface{}，其中键是模板中调用的函数名，值是对应的 Go 函数。

步骤一：定义你的自定义函数

首先，你需要编写一个普通的 Go 函数。这个函数可以接收任意数量和类型的参数，并返回一个值（也可以返回 error，但通常我们只返回结果）。

// 格式化时间的函数func formatTime(t time.Time) string {    return t.Format("2006-01-02 15:04:05")}// 将字符串转为大写func toUpper(s string) string {    return strings.ToUpper(s)}// 计算两个数的和func add(a, b int) int {    return a + b}

步骤二：创建 FuncMap 并注册函数

接下来，我们将这些函数放入一个 template.FuncMap 中：

funcMap := template.FuncMap{    "formatTime": formatTime,    "toUpper":   toUpper,    "add":       add,}

注意：函数名（如 "formatTime"）就是你在模板中调用时使用的名字。

步骤三：将 FuncMap 注册到模板

在解析模板之前，使用 .Funcs() 方法将函数映射注入到模板对象中：

tmpl := template.Must(template.New("example").Funcs(funcMap).ParseFiles("template.html"))

或者，如果你使用的是字符串模板：

tmplStr := `<div>当前时间：{{ .Now | formatTime }}</div><div>用户名：{{ "alice" | toUpper }}</div><div>总分：{{ add 80 95 }}</div>`tmpl := template.Must(template.New("demo").Funcs(funcMap).Parse(tmplStr))

完整示例代码

下面是一个完整的可运行示例：

package mainimport (    "html/template"    "os"    "strings"    "time")func formatTime(t time.Time) string {    return t.Format("2006-01-02 15:04:05")}func toUpper(s string) string {    return strings.ToUpper(s)}func add(a, b int) int {    return a + b}func main() {    funcMap := template.FuncMap{        "formatTime": formatTime,        "toUpper":   toUpper,        "add":       add,    }    tmplStr := `<!DOCTYPE html><html><head><title>Go模板函数示例</title></head><body>  <p>当前时间：{{ .Now | formatTime }}</p>  <p>欢迎，{{ "john doe" | toUpper }}！</p>  <p>数学成绩：{{ add 78 92 }} 分</p></body></html>`    tmpl := template.Must(template.New("webpage").Funcs(funcMap).Parse(tmplStr))    data := struct {        Now time.Time    }{        Now: time.Now(),    }    tmpl.Execute(os.Stdout, data)}