17370845950

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/temp
late"
)

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 等内置函数，配合清晰的数据结构设计，完全能满足绝大多数模板分支与渲染需求——无需妥协表达力，只需适应它的范式。