术语表

正则表达式(regular expression)

定义搜索模式的字符序列。

难度
参考

开始之前,你需要

  • 在文档里遇到不认识的 Hugo 术语时查阅

读完之后你能

  • 写出模板里可用的正则,并在报错时判断是不是用了 Go 不支持的高级语法

接着读:FindRE

正则表达式(regular expression,又称 regex)是定义搜索模式的字符序列。在模板或项目配置中定义正则表达式时,请使用 RE2 语法。

为什么重要

模板里所有带 RE 的函数(strings.FindRE、strings.ReplaceRE、strings.FindRESubmatch 等)都用 Go 的 RE2 引擎,它不支持后向引用和前后瞻,写成 (?<=...) 会直接报 invalid or unsupported Perl syntax 一类的错误。 另一个容易忽略的点是匹配范围:FindRE 只返回匹配到的片段,是否区分大小写、是否跨行都取决于你在模式里写的标志;排查时先把模式单独放进一个最小模板里跑,比在完整页面里猜快。

延伸阅读:strings.FindRE · strings.ReplaceRE