数学函数 on Hugo 中文文档

math.Abs

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Abs -2.1 }} → 2.1

math.Acos

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Acos 1 }} → 0

math.Add

Fri, 02 Oct 2026 00:00:00 +0800

如果其中一个数字是浮点数（float），结果为 float。

{{ add 12 3 2 }} → 17

也可以用 add 函数拼接字符串。

{{ add "hu" "go" }} → hugo

math.Asin

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Asin 1 }} → 1.5707963267948966

math.Atan

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Atan 1 }} → 0.7853981633974483

math.Atan2

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Atan2 1 2 }} → 0.4636476090008061

math.Ceil

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Ceil 2.1 }} → 3

math.Cos

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Cos 1 }} → 0.5403023058681398

math.Counter

Fri, 02 Oct 2026 00:00:00 +0800

该计数器对单语言与多语言项目都是全局的，每次构建的初始值为 1。

layouts/page.html

{{ warnf "page.html called %d times" math.Counter }}

WARN  page.html called 1 times
WARN  page.html called 2 times
WARN  page.html called 3 times

可以用这个函数来：

生成如上例所示的唯一警告信息；warnf 函数会抑制重复的消息
为 resources.FromString 函数生成唯一的目标路径，此时目标路径同时也是缓存键

math.Div

Fri, 02 Oct 2026 00:00:00 +0800

如果其中一个数字是浮点数（float），结果为 float。

{{ div 12 3 2 }} → 2

math.Floor

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Floor 1.9 }} → 1

math.Log

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Log 42 }} → 3.737

math.Max

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Max 1 (slice 2 3) 4 }} → 4

math.MaxInt64

Fri, 02 Oct 2026 00:00:00 +0800

（0.147.3 新增）

{{ math.MaxInt64 }} → 9223372036854775807

当需要模拟一个持续到满足中断条件才结束的循环时，这个函数很有用。例如：

math.Min

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Min 1 (slice 2 3) 4 }} → 1

math.Mod

Fri, 02 Oct 2026 00:00:00 +0800

{{ mod 15 3 }} → 0

math.ModBool

Fri, 02 Oct 2026 00:00:00 +0800

{{ modBool 15 3 }} → true

math.Mul

Fri, 02 Oct 2026 00:00:00 +0800

如果其中一个数字是浮点数（float），结果为 float。

{{ mul 12 3 2 }} → 72

math.Pi

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Pi }} → 3.141592653589793

math.Pow

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Pow 2 3 }} → 8

math.Product

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Product 1 (slice 2 3) 4 }} → 24

math.Rand

Fri, 02 Oct 2026 00:00:00 +0800

math.Rand 函数返回半开区间 [0.0, 1.0) 内的伪随机数。

{{ math.Rand }} → 0.6312770459590062

生成闭区间 [0, 5] 内的随机整数：

{{ math.Rand | mul 6 | math.Floor }}

生成闭区间 [1, 6] 内的随机整数：

{{ math.Rand | mul 6 | math.Ceil }}

生成闭区间 [0, 4.9] 内、小数点后保留一位的随机浮点数：

math.Round

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Round 1.5 }} → 2

math.Sin

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Sin 1 }} → 0.8414709848078965

math.Sqrt

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Sqrt 81 }} → 9

math.Sub

Fri, 02 Oct 2026 00:00:00 +0800

如果其中一个数字是浮点数（float），结果为 float。

{{ sub 12 3 2 }} → 7

math.Sum

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Sum 1 (slice 2 3) 4 }} → 10

math.Tan

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.Tan 1 }} → 1.557407724654902

math.ToDegrees

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.ToDegrees 1.5707963267948966 }} → 90

math.ToRadians

Fri, 02 Oct 2026 00:00:00 +0800

{{ math.ToRadians 90 }} → 1.5707963267948966