cast.ToFloat
返回给定值转换后的十进制浮点数(base 10)。
这一页解决什么问题
模板里的数字不总是数字:前置元数据里的 price = "42.5"(加了引号)、来自 hugo.Data 的 JSON 字段、从 URL 或 shortcode 参数拿到的字符串,进入模板后都可能是 string。拿字符串去做 add、mul 这类算术,或者与数字比较,得到的不是想要的结果。
float(即 cast.ToFloat)把它变成 float64,之后就能参与算术与比较。
什么时候用,什么时候别用
该用:
- 参与浮点运算:价格、评分、比例、单位换算;
- 参与数字比较(
gt、lt、eq与数字字面量比较时类型必须一致); - 值可能来自「字符串写法的配置」,又需要按数字用。
别用:
- 只需要整数(计数、下标、
collections.First的 N)→ 用cast.ToInt:float返回float64,再当整数用还得转一次; - 只是想把数字输出到页面上 → 直接
{{ 11 }},模板会渲染成文本; - 想判断字符串是不是合法数字 → 先转换会直接报错(见边界表),需要先用
strings系列或try做校验; - 想解析时间戳 → 用
time.AsTime,float不会把「2024-01-01」这种文本认成数字。
上游给出的各种进制输入结果
输入为十进制(base 10)时:
{{ float 11 }} → 11 (float64)
{{ float "11" }} → 11 (float64)
{{ float 11.1 }} → 11.1 (float64)
{{ float "11.1" }} → 11.1 (float64)
{{ float 11.9 }} → 11.9 (float64)
{{ float "11.9" }} → 11.9 (float64)输入为二进制(base 2)时:
{{ float 0b11 }} → 3 (float64)输入为八进制(base 8)时(两种记法都可用):
{{ float 011 }} → 9 (float64)
{{ float "011" }} → 11 (float64)
{{ float 0o11 }} → 9 (float64)输入为十六进制(base 16)时:
{{ float 0x11 }} → 17 (float64)注意 {{ float "011" }} → 11:字符串走的是十进制解析,前导零不表示八进制;只有不加引号的数字字面量才按 Go 的进制规则求值。这与 cast.ToInt 不同——int "011" 得到 9,int "0b11" 得到 3。实测:int "0b11" → 3、int "0o11" → 9、int "0x11" → 17,而 float 对同样这三个带进制前缀的字符串全部报错——字符串里带进制前缀时只有 cast.ToInt 能解析。
完整示例:把字符串价格转成数字再计算
{{ $a := "11.9" }}
{{ $b := 0x11 }}
<p>{{ float $a }} / {{ float $b }}</p>
<p>相加:{{ add (float "11") 0.5 }}</p>
<p>空字符串:{{ float "" }},nil:{{ float nil }}</p>Hugo 渲染为(变量赋值行本身会留下空行,这里省略):
<p>11.9 / 17</p>
<p>相加:11.5</p>
<p>空字符串:0,nil:0</p>你应当看到什么:"11.9" 与 0x11 都变成了 float64;add (float "11") 0.5 得到 11.5,说明转换后的值真的能参与算术(直接 add "11" 0.5 会因类型不符而报错)。空字符串与 nil 都静默变成 0——这是最危险的一条:数据缺失时不会报错,只会得到 0,所以表单/配置场景要自己判空。
返回值边界(实测)
测量条件:Hugo 0.167.0 extended,单语言站点(locale = 'zh-CN'),Windows。
| 输入 | 结果 | 是否报错 |
|---|---|---|
数字字面量、数字字符串(11、"11"、"11.9") |
对应的 float64 |
否 |
"011" |
11(字符串按十进制解析) |
否 |
"" |
0 |
否 |
nil |
0 |
否 |
布尔 true / false |
1 / 0 |
否 |
"0b11"、"0o11"、"0x11"(带进制前缀的字符串) |
—— | 是:error calling float: unable to cast "0b11" of type string to float64: strconv.ParseFloat: parsing "0b11": invalid syntax |
"abc"(无法解析的字符串) |
—— | 是:error calling float: unable to cast "abc" of type string to float64: strconv.ParseFloat: parsing "abc": invalid syntax |
| 返回类型 | float64 |
否 |
常见坑
| 类别 | 症状 | 真因 | 怎么修 |
|---|---|---|---|
| 没报错但结果不对 | 价格字段缺失时算出 0 元,页面上却看不出来 | float "" 与 float nil 都返回 0,不报错 |
转换前用 with / isset 判空,或给默认值 default 0 |
| 没报错但结果不对 | float "011" 得到 11,不是 9 |
字符串按十进制解析,前导零是八进制只对不加引号的数字字面量成立 | 如果是八进制字符串,自己按需处理;十进制场景先 strings.TrimLeft "0" |
| 报错看不懂 | unable to cast "abc" of type string to float64 |
传进来的字符串不是数字 | 检查上游数据源;确认这不是把空字符串以外的文本误当数字 |
| 报错看不懂 | wrong type for value; expected float64; got string |
忘了转换,直接把字符串传给了算术函数 | 在传入处套一层 cast.ToFloat |
更多排查入口见故障排查。