compare.Eq
报告第一个参数是否等于后续参数中的任意一个。
这一页解决什么问题
模板里最常见的判断是「这两个值是不是同一个」:当前页是不是 post 类型、某个参数是不是等于 featured、循环到的这个元素是不是目标元素。Go 模板的 if 需要一个布尔值,而 eq 就是把「相等」变成布尔值的那个函数。
eq 与 compare.Eq 是同一个函数:eq 是别名,日常模板里写 eq 更短,遇到问题查文档时用 compare.Eq 这个名字能搜到本页。
什么时候用,什么时候别用
该用:
- 单值判断:
{{ if eq .Params.layout "post" }}; - 一次和多个候选比较:
eq $x 1 2 3,只要任何一个相等就返回true; - 数字比较:不必自己把
int和float统一(实测eq 1 1.0→true); - 比较切片、映射的内容(实测按内容逐项比较,见边界表)。
别用:
- 判断「某个值是否在切片里」→ 用
collections.In; - 从集合里筛元素 → 用
where; - 只想取反 → 用
ne或not; - 比较数字与字符串字面量 → 实测
eq 1 "1"是false:相等比较不会把字符串当数字。需要数值相等就先cast.ToInt/cast.ToFloat; - 比较浮点数是否相等 → 精度误差会让它不可靠,比区间用
ge/lt。
用法
compare.Eq 函数报告第一个参数是否等于后续参数中的任意一个。数字按值比较,与类型无关。你也可以用该函数比较字符串、布尔值、日期以及其他可比较的数据类型。
示例
go-html-template
{{ compare.Eq 1 1 }} → true
{{ compare.Eq 1 2 }} → false
{{ compare.Eq 1 1 1 }} → true
{{ compare.Eq 1 1 2 }} → true
{{ compare.Eq 1 2 1 }} → true
{{ compare.Eq 1 2 2 }} → false比较不同类型的数字:
go-html-template
{{ compare.Eq 1 1.0 }} → true比较其他数据类型:
go-html-template
{{ compare.Eq "ab" "a" }} → false
{{ compare.Eq time.Now (time.AsTime "1964-12-30") }} → false
{{ compare.Eq true false }} → false完整示例:判断页面布局与多个候选值
layouts/_partials/layout-check.htmlgo-html-template
{{ $layout := "post" }}
<p>{{ eq $layout "post" }}</p>
<p>{{ eq 1 1.0 }}</p>
<p>{{ eq 1 "1" }}</p>
<p>{{ eq (slice 1 2) (slice 1 2) }}</p>
<p>{{ eq (dict "a" 1) (dict "a" 2) }}</p>Hugo 渲染为(变量赋值行本身会留下空行,这里省略):
html
<p>true</p>
<p>true</p>
<p>false</p>
<p>true</p>
<p>false</p>你应当看到什么:第三行是 false——1 与 "1" 不相等,这是最容易踩的一条;第四行是 true——切片按内容比较,不是比较引用。把第三行换成 eq (cast.ToInt "1") 1 才会得到 true。
返回值边界(实测)
测量条件:Hugo 0.167.0 extended,单语言站点(locale = 'zh-CN'),Windows。
| 比较 | 结果 | 是否报错 |
|---|---|---|
eq 1 1 / eq 1 2 |
true / false |
否 |
eq 1 1.0(int 与 float) |
true |
否 |
eq 1 "1"、eq "1" 1(数字与字符串) |
false |
否 |
eq nil nil / eq nil "x" |
true / false |
否 |
eq "ab" "ab" |
true(字符串按内容) |
否 |
eq (slice 1 2) (slice 1 2) |
true(按内容逐项比较) |
否 |
eq (slice 1) (slice 2)、eq (slice 1 2) (slice 2 1) |
false |
否 |
eq (dict "a" 1) (dict "a" 1) / eq (dict "a" 1) (dict "a" 2) |
true / false |
否 |
eq(0 个参数) |
—— | 是:wrong number of args for eq: want at least 1 got 0 |
eq 1(1 个参数) |
—— | 是:error calling eq: missing arguments for comparison |
| 返回类型 | bool |
否 |
常见坑
| 类别 | 症状 | 真因 | 怎么修 |
|---|---|---|---|
| 没报错但结果不对 | 参数里写着 1,eq .Params.n 1 却是 false |
比较双方类型不同,且不强转字符串 | 用 cast.ToInt / cast.ToFloat 统一类型,或把字面量写成字符串 |
| 没报错但结果不对 | eq $a $b 在切片上小心地用却不报错 |
切片、映射按内容比较(实测) | 比较「是不是同一个对象」不要用 eq,改用别的方式(如比较 .RelPermalink) |
| 没报错但结果不对 | eq 1 1.1 之类浮点比较结果不合预期 |
浮点精度 | 比区间:and (ge $x $lo) (lt $x $hi) |
| 报错看不懂 | missing arguments for comparison |
只传了一个参数 | eq 至少需要两个参数 |
| 报错看不懂 | wrong number of args for eq: want at least 1 got 0 |
参数写漏了(常见于管道写法 {{ eq }}) |
补上参数;管道形式是 {{ $x | eq 1 }} |
更多排查入口见故障排查。