Page

Len

返回给定页面渲染后内容的长度(字节数)。

签名
PAGE.Len
返回类型
int

这一页解决什么问题

Len 返回页面渲染后内容的字节数。它是快速的「这一页有多少内容」指标,常用于列表里给空页面兜底、或做粗略的分量判断(真正给读者看的字数请用 WordCount)。

什么时候用,什么时候别用

该用:

  • 判断一个页面是否「有正文」(gt .Len 0);
  • 需要字节长度(例如截断输出、估算传输体积)。

别用:

  • 想要词数或阅读时长 → 用 WordCount / FuzzyWordCount / .ReadingTime;
  • 想要纯文本长度 → 用 Plain;
  • 期望它等于正文文件的字节数 → 它统计的是渲染后 HTML(含标签、换行),比 Markdown 源文件大。

用法

go-html-template
{{ .Len }} → 42

完整示例:区分空正文页面与有正文页面

最小站点:content/docs/guide/alpha.md(正文含标题、摘要与短代码)、content/docs/guide/_index.md(只有前置元数据的 section 页)、content/_index.md(首页)。模板放在 layouts/_default/single.html:

layouts/_default/single.htmlgo-html-template
<p>{{ .Len }} 字节</p>
{{ if gt .Len 0 }}<p>本页有正文</p>{{ else }}<p>本页没有正文</p>{{ end }}

hugo --source <站点目录> --ignoreCache 构建后,各页面的实测值:

页面 .Len
alpha.md(正文含中文、三个标题、一个短代码) 267
beta.md(一句话正文) 55
posts/first.md(一句英文) 93
首页(一句中文) 32
section 页 /docs/、/docs/guide/ 0
术语页 /tags/hugo/ 0

你应当看到什么:分支页面(section、术语页)通常为 0,普通页面为其渲染 HTML 的字节数;一个汉字在 UTF-8 下占 3 字节,所以中文页面的 .Len 会明显大于字数。

返回值边界(实测)

测量条件:Hugo 0.167.0 extended,Windows;内容与上表一致。

情况 结果 是否报错
有正文的普通页面 渲染后 HTML 的字节数(如 267、55、93) 否
只有前置元数据的 section 页 0 否
术语页 / 分类法页 0 否
首页有正文时 大于 0(实测 32) 否
返回类型 int 否

常见坑

类别 症状 真因 怎么修
数值远大于源文件 以为算错了 统计的是渲染后的 HTML(含标签与换行) 想要字数用 WordCount
中文页面数值偏大 一个汉字 3 字节 字节数 ≠ 字数 用 WordCount(配合 hasCJKLanguage)
分支页面判断为「空」 section 页 .Len 为 0 分支页面通常没有正文 用 IsPage / IsBranch 分流,不要只靠 .Len

更多排查入口见故障排查。