字符串函数 on Hugo 中文文档

strings.Chomp

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

如果参数的类型是 template.HTML，则返回 template.HTML；否则返回 string。

{{ chomp "foo\n" }} → foo
{{ chomp "foo\n\n" }} → foo

{{ chomp "foo\r\n" }} → foo
{{ chomp "foo\r\n\r\n" }} → foo

strings.Contains

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

{{ strings.Contains "Hugo" "go" }} → true

该检查区分大小写：

{{ strings.Contains "Hugo" "Go" }} → false

strings.ContainsAny

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

{{ strings.ContainsAny "Hugo" "gm" }} → true

该检查区分大小写：

{{ strings.ContainsAny "Hugo" "Gm" }} → false

strings.ContainsNonSpace

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

空白字符包括 \t、\n、\v、\f、\r，以及 Unicode 空格分隔符（Unicode Space Separator）类别中的字符。

{{ strings.ContainsNonSpace "\n" }} → false
{{ strings.ContainsNonSpace " " }} → false
{{ strings.ContainsNonSpace "\n abc" }} → true

strings.Count

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

如果 SUBSTR 是空字符串，该函数返回 STRING 中 Unicode 码点（code point）的数量加 1。

{{ "aaabaab" | strings.Count "a" }} → 5
{{ "aaabaab" | strings.Count "aa" }} → 2
{{ "aaabaab" | strings.Count "aaa" }} → 1
{{ "aaabaab" | strings.Count "" }} → 8

strings.CountRunes

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

strings.RuneCount 函数统计字符串中的每一个 rune，而 strings.CountRunes 会排除空白字符。

{{ "Hello, 世界" | strings.CountRunes }} → 8

strings.CountWords

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

{{ "Hugo is a static site generator." | countwords }} → 6

strings.Diff

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

用 strings.Diff 比较两段字符串并渲染出带高亮的差异：

{{ $want := `
<p>The product of 6 and 7 is 42.</p>
<p>The product of 7 and 6 is 42.</p>
`}}

{{ $got := `
<p>The product of 6 and 7 is 42.</p>
<p>The product of 7 and 6 is 13.</p>
`}}

{{ $diff := strings.Diff "want" $want "got" $got }}
{{ transform.Highlight $diff "diff" }}

渲染结果：

strings.FindRE

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

默认情况下，findRE 会找出所有匹配项。可以用可选的 LIMIT 参数限制匹配数量。

指定正则表达式时，请使用原始的字符串字面量（反引号），而不要使用解释型字符串字面量（双引号），以简化语法：使用解释型字符串字面量时必须转义反斜杠。

Go 的正则表达式包实现的是 RE2 语法。大致来说，RE2 语法是 PCRE 所接受语法的一个子集，并且有若干注意事项。注意，不支持 RE2 的 \C 转义序列。

strings.FindRESubmatch

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

默认情况下，findRESubmatch 会找出所有匹配项。可以用可选的 LIMIT 参数限制匹配数量。返回值为 nil 表示没有匹配。

strings.FirstLower

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

（0.167.0 新增）

{{ strings.FirstLower "HUGO" }} → hUGO

strings.FirstUpper

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

{{ strings.FirstUpper "hugo" }} → Hugo

strings.HasPrefix

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

{{ hasPrefix "Hugo" "Hu" }} → true

strings.HasSuffix

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

{{ hasSuffix "Hugo" "go" }} → true

strings.Repeat

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

{{ strings.Repeat 3 "yo" }} → yoyoyo

strings.Replace

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

{{ $s := "Batman and Robin" }}
{{ replace $s "Robin" "Catwoman" }} → Batman and Catwoman

用 LIMIT 参数限制替换次数：

{{ replace "aabbaabb" "a" "z" 2 }} → zzbbaabb

strings.ReplacePairs

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

（0.158.0 新增）

用 strings.ReplacePairs 函数可以在一次操作中对字符串完成多处替换，这比依次调用 strings.Replace 函数更快。

依次替换需要多次函数调用与变量重新赋值：

strings.ReplaceRE

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

Go 的正则表达式包实现的是 RE2 语法。大致来说，RE2 语法是 PCRE 所接受语法的一个子集，并且有若干注意事项。注意，不支持 RE2 的 \C 转义序列。

{{ $s := "a-b--c---d" }}
{{ replaceRE `(-{2,})` "-" $s }} → a-b-c-d

用 LIMIT 参数限制替换次数：

strings.RuneCount

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

strings.CountRunes 函数会排除空白字符，而 strings.RuneCount 统计字符串中的每一个 rune。

{{ "Hello, 世界" | strings.RuneCount }} → 9

strings.SliceString

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

START 与 END 位置从 0 开始计数，0 表示字符串的第一个字符。如果不指定 START，子串从位置 0 开始；如果不指定 END，子串在最后一个字符之后结束。

{{ slicestr "BatMan" }} → BatMan
{{ slicestr "BatMan" 3 }} → Man
{{ slicestr "BatMan" 0 3 }} → Bat

START 与 END 参数表示一个半开区间（half-open interval）的两个端点，这个概念初次接触时可能不太好理解。你可能会觉得 strings.Substr 函数更容易掌握。

strings.Split

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

示例：

{{ split "tag1,tag2,tag3" "," }} → ["tag1", "tag2", "tag3"]
{{ split "abc" "" }} → ["a", "b", "c"]

strings.Substr

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

起始位置从 0 开始计数，0 表示字符串的第一个字符。如果不指定 START，子串从位置 0 开始。START 为负数时，从字符串末尾开始提取字符。

如果不指定 LENGTH，子串包含从 START 位置到字符串末尾的所有字符。LENGTH 为负数时，将从字符串末尾略去相应数量的字符。

strings.Title

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

{{ title "table of contents (TOC)" }} → Table of Contents (TOC)

默认情况下，Hugo 遵循 Associated Press Stylebook 发布的大小写规则。如果你更希望采用以下某种方式，请修改[项目配置][]：

遵循 Chicago Manual of Style 发布的大小写规则
每个单词的首字母都大写
只把第一个单词的首字母大写
关闭 title 函数的效果

如果主题使用了 title 函数，而你更愿意按需手动处理大小写，最后一种选项会很有用。

strings.ToLower

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

{{ lower "BatMan" }} → batman

strings.ToUpper

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

{{ upper "BatMan" }} → BATMAN

strings.Trim

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

{{ trim "++foo--" "+-" }} → foo

strings.TrimLeft

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

{{ strings.TrimLeft "a" "abba" }} → bba

strings.TrimLeft 函数会在可能的情况下把参数转换为字符串：

{{ strings.TrimLeft 21 12345 }} → 345 (string)
{{ strings.TrimLeft "rt" true }} → ue

strings.TrimPrefix

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

{{ strings.TrimPrefix "a" "aabbaa" }} → abbaa
{{ strings.TrimPrefix "aa" "aabbaa" }} → bbaa
{{ strings.TrimPrefix "aaa" "aabbaa" }} → aabbaa

strings.TrimRight

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

{{ strings.TrimRight "a" "abba" }} → abb

strings.TrimRight 函数会在可能的情况下把参数转换为字符串：

{{ strings.TrimRight 54 12345 }} → 123 (string)
{{ strings.TrimRight "eu" true }} → tr

strings.TrimSpace

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

空白字符包括 \t、\n、\v、\f、\r，以及 Unicode 空格分隔符（Unicode Space Separator）类别中的字符。

{{ strings.TrimSpace "\n\r\t   foo   \n\r\t" }} → foo

strings.TrimSuffix

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

{{ strings.TrimSuffix "a" "aabbaa" }} → aabba
{{ strings.TrimSuffix "aa" "aabbaa" }} → aabb
{{ strings.TrimSuffix "aaa" "aabbaa" }} → aabbaa

strings.Truncate

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

截断被标记为安全 HTML 的值（例如 safe.HTML 函数返回的值）时，strings.Truncate 会补全因截断而未闭合的标签，而不是从标签中间切断：

{{ "<em>Keep my HTML</em>" | safeHTML | strings.Truncate 10 }} → <em>Keep my …</em>