math.Add
返回把第一个数字与一个或多个数字相加的结果。
这一页解决什么问题
模板里没有 + 运算符。想在页面上显示「阅读时长 = 字数 ÷ 速度」之外的任何加法(累计数、偏移量、序号加一),都得用 add(math.Add 的别名)。
go-html-template
{{ add 12 3 2 }} → 17什么时候用,什么时候别用
该用:
- 两个或多个数字相加,包括在管道里递增:
{{ $n | add 1 }}; - 需要「至少一个浮点数时结果为浮点数」的自动类型提升。
别用:
- 拼接字符串 → 用
fmt.Printf或collections.Delimit;虽然实测add "hu" "go"可行(得到hugo),但读代码的人容易误解; - 求一组数字的和 → 用
math.Sum(可以直接吃切片); - 把字符串解析成数字 → 用
cast系列。
如果其中一个数字是浮点数(float),结果为 float。
go-html-template
{{ add 12 3 2 }} → 17完整示例:累计计数与类型提升
layouts/_partials/add-demo.htmlgo-html-template
{{ $count := 0 }}
{{ range slice "a" "b" "c" }}{{ $count = add $count 1 }}{{ end }}
<p>共 {{ $count }} 项(类型 {{ printf "%T" $count }})</p>
<p>整数相加:{{ add 12 3 2 }}(类型 {{ printf "%T" (add 12 3 2) }})</p>
<p>含浮点数:{{ add 12 3.5 }}(类型 {{ printf "%T" (add 12 3.5) }})</p>
<p>管道写法:{{ 1 | add 2 | add 3 }}</p>Hugo 0.167.0 实测渲染为:
html
<p>共 3 项(类型 int64)</p>
<p>整数相加:17(类型 int64)</p>
<p>含浮点数:15.5(类型 float64)</p>
<p>管道写法:6</p>你应当看到什么:全整数相加得到 int64,一旦有浮点数就提升为 float64;管道写法 {{ 1 | add 2 | add 3 }} 依次累加得到 6——管道把左侧的值作为最后一个参数传给函数。
返回值边界(实测)
测量条件:Hugo 0.167.0 extended,单语言站点,Windows。
| 输入 | 结果 | 是否报错 |
|---|---|---|
12 3 2 |
17(类型 int64) |
否 |
12 3.5 |
15.5(类型 float64) |
否 |
"hu" "go"(上游说明可拼接字符串) |
hugo(类型 string,实测一致) |
否 |
1 "x"(数字 + 非数字字符串) |
—— | 是:error calling add: can't apply the operator to the values |
只传一个参数(如 add 5) |
—— | 是:error calling add: must provide at least two numbers |
| 不传参数 | —— | 是(同类参数个数错误) |
| 返回类型 | any:全整数为 int64,含浮点为 float64,字符串为 string |
否 |
常见坑
| 类别 | 症状 | 真因 | 怎么修 |
|---|---|---|---|
| 报错看不懂 | error calling add: must provide at least two numbers |
只传了一个参数(例如写成 add $n) |
至少写两个:add $n 1 |
| 报错看不懂 | can't apply the operator to the values |
一边是数字、一边是非数字字符串 | 用 cast.ToInt 转换,或核对参数来源 |
| 没报错但结果不对 | 结果是 3 而不是 3.5 |
两个操作数都是整数,触发整数运算 | 至少写一个浮点数(3.0),或先 cast.ToFloat |
| 没报错但结果不对 | 循环里累加始终不变 | 忘了把返回值赋回去:add 不会原地修改 |
写 {{ $n = add $n 1 }}(注意是 =) |
| 没报错但结果不对 | 字符串被当数字相加,结果是拼接 | 用了字符串参数 | 明确目的:拼接用 printf,求和用 math.Sum |
更多排查入口见故障排查。