
go 的 text/template 包不支持原生的 `==`、`!=` 等操作符用于模板内比较,而需使用内置函数(如 `eq`、`ne`、`lt` 等)实现字段判断,本文详解其正确用法及常见陷阱。
Go 标准库中的 text/template 包设计遵循“逻辑与表现分离”原则,因此模板内不支持运算符重载或任意表达式求值(例如 .Brand == "Coke" 会直接报错:unexpected "=" in if)。取而代之的是,它提供了一组安全、预定义的比较函数,全部以小写形式暴露在模板作用域中。
最常用的是 eq 函数,用于判断两个值是否相等。其语法为:
{{if eq .Field "value"}}...{{else}}...{{end}}它支持任意数量的参数(二元及以上),语义为“所有参数两两相等”,常用于单次双值比较。
✅ 正确示例:
package main
import (
"os"
"text/template"
)
type Product struct {
Brand string
Price float64
}
func main() {
data := Product{Brand: "Coke", Price: 2.5}
tpl := `{{if eq .Brand "Coke"}}It's a coke{{else}}It's something else{{end}}`
t := template.Must(template.New("test").Parse(tpl))
t.Execute(os.Stdout, data) // 输出:It's a coke
}? 其他常用比较函数包括:
- ne:不等于({{if ne .Status "active"}})
- lt / le / gt / ge:小于/小于等于/大于/大于等于(仅适用于数字、字符串字典序、时间等可比较类型)
- and / or / not:逻辑组合({{if and (eq .Brand "Coke") (gt .Price 2.0)}})
⚠️ 注意事项:
- 所有函数调用必须显式写出函数名,不可省略括号或使用中缀操作符;
- 字段访问(如 .Brand)和字面量(如 "Coke")均作为函数参数传入,顺序敏感;
- 比较时类型需兼容:eq "1" 1 返回 false(字符串 vs 整数),Go 不做隐式类型转换;
- 若字段为指针或可能为 nil,建议先用 if 判断非空,再调用 eq,避免 panic。
? 小技巧:可通过 template.Funcs() 注册自定义函数(如 contains、toUpper),进一步扩展模板能力,但核心比较逻辑仍应优先使用内置函数以保证安全与可维护性。
总结:text/template 的“弱表达式”设计是刻意为之的安全机制。掌握 eq、ne 等内置函数,配合清晰的数据结构设计,完全能满足绝大多数模板分支与渲染需求——无需妥协表达力,只需适应它的范式。









