术语表

rune

把单个字符表示为一个数值的方式。

难度
参考

开始之前,你需要

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

读完之后你能

  • 能判断一处文本处理该按 rune(字符)还是按字节计算,并知道混淆后的典型症状

接着读:CountRunes

rune 是一种把单个字符表示为数值的方式。在 Hugo 和 Go 中,文本以字节序列存储。然而,像 x 这样的基本字母只占一个字节,而 ü 这样的单个字符却由多个字节组成。无论存储一个字符需要多少字节,rune 都把整个字符表示为一个值。

严格来说,rune 只是 32 位 integer 的另一个名称。它存储 Unicode code point,也就是分配给该特定字符的官方编号。

当你希望按字符而不是按原始数据大小来操作文本时,就是在使用 rune。在 template 中使用 rune literal 书写 rune,例如 'x'、'\n' 或 'ü'。

为什么重要

中文文本里一个汉字占 3 个字节,用 len 或按字节截断会把汉字切碎,输出乱码或问号;改用按字符计算的 countrunes 才能得到正确字数。看到「中文被截成半个字」「字数统计明显偏大」,多半就是把 rune 当成了字节。

延伸阅读:countrunes、字符串函数