模板中不可用+或concat()拼接字段,必须在Go后端预拼接或通过FuncMap注册导出函数(如join)调用,且需防范空指针与类型错误。

模板里用 {{.Field}} 直接取值,别手动拼接
Gin 的 html/template 不支持 JavaScript 那种 + 或 concat() 拼接语法。你不能在模板里写 {{.FirstName + .LastName}} 或 {{.FirstName.concat(" ", .LastName)}}——这些会直接报错或静默失败。
正确做法是:把拼接逻辑移到 Go 后端,传一个已拼好的字段过去。比如:
r.GET("/user", func(c *gin.Context) {
data := gin.H{
"fullName": "John" + " " + "Doe",
"title": "User Profile",
}
c.HTML(http.StatusOK, "user.html", data)
})
然后模板里只写 {{.fullName}}。这样既安全,又避免模板变重、难调试。
需要动态组合?用 template.FuncMap 注册自定义函数
如果拼接规则多变(比如加前缀、截断、URL encode),硬编码字段不现实。这时该用 template.FuncMap 注册一个 Go 函数,在模板里调用:
r.SetFuncMap(template.FuncMap{"join": func(a, b string) string { return a + " " + b }})- 模板中写
{{join .FirstName .LastName}} - 注意:函数必须导出(首字母大写),参数和返回值类型要明确,且不能有副作用
常见坑:函数名在 FuncMap 里注册后,模板里调用时大小写必须完全一致;传参个数、类型错一个,c.HTML 渲染时会 panic,但错误信息不提示具体哪行模板出错。
嵌套结构字段拼接?用点号链式访问,但注意空指针
比如数据是 gin.H{"user": map[string]interface{}{"profile": map[string]string{"first": "Jane", "last": "Smith"}}},模板里可以写 {{.user.profile.first}} {{.user.profile.last}},但不能写 {{.user.profile.first .user.profile.last}}——空格不是拼接符,那是两个独立输出。
更安全的写法是提前在 Go 层构造好嵌套字段:
user := map[string]interface{}{
"name": user.Profile.First + " " + user.Profile.Last,
}
c.HTML(http.StatusOK, "profile.html", gin.H{"user": user})
否则一旦 .user.profile 是 nil,模板渲染直接 panic,且 Gin 默认 recovery 中间件不会捕获这种模板执行期错误。
HTML 内容含变量?用 {{.Field | safeHTML}} 防转义
默认所有 {{.X}} 输出都会被 HTML 转义(比如 变成 )。如果你真要拼接 HTML 字符串(比如富文本摘要),必须显式标记为安全:
- 注册函数时加上
template.HTML返回类型:func(s string) template.HTML { return template.HTML(s) } - 或者在模板里用管道:
{{.htmlContent | safeHTML}}
漏掉这步,拼出来的 HTML 标签会被当成纯文本显示,页面就“裸奔”了。这不是拼接逻辑问题,而是安全机制默认生效——容易忽略,但后果明显。











