几千篇文章之后的性能账

构建几分钟?首页几 MB?搜索还能用吗?内容规模上去以后,真正会先崩的是哪三处。

选 Hugo 的主要理由是构建速度,但"几千篇"这个量级上,构建从来不是第一个崩的地方。先崩的通常是首页体积、客户端搜索索引,以及图片托管。

构建:几秒的事

Hugo 没有增量构建,每次都是全量。听起来可怕,实际上 3000 篇纯文本的构建时间取决于模板复杂度而不是文章数——大多数时间花在图片处理和模板渲染上,而不是解析 Markdown。

真正会拖慢构建的是这三件事,按影响排序:

  1. 图片处理。每张封面生成 4 个宽度 × WebP/JPEG 两套 = 8 个文件。3000 篇就是 24000 次编码。这是唯一值得做缓存的地方(Hugo 会自动缓存到 resources/_gen,但 CI 上每次都是冷的)。
  2. 没有 partialCached 的循环内 partial。侧栏、页脚、图标这类与页面无关的片段,在文章循环里逐个调用就是灾难。
  3. taxonomy 页爆炸。每个标签一页,每个标签的分页再乘一层。标签数量失控时页面数会以乘积增长。
1
2
# 看一眼到底慢在哪
hugo --templateMetrics --templateMetricsHints

首页体积

如果首页用大卡片封面流,代价是每张卡片都要一张真实图片。6 张卡片 × 每张 ~200KB(1080 宽,WebP)≈ 1.2MB——已经超过一个中文文字页面的合理预算。本站干脆不用封面,首页卡片只有文字,这条账直接归零。

如果以后要加回封面,三条硬约束:

  • 封面必须走 srcset,手机上不能下载桌面尺寸;
  • 首屏之外用 loading="lazy"(主题已默认处理);
  • 列表页封面宽度上限压到 1080,不要用原图。
1
2
3
4
5
<img
  srcset="cover-720.webp 720w, cover-1080.webp 1080w, cover-1440.webp 1440w"
  sizes="(max-width: 767px) calc(100vw - 30px), 950px"
  loading="lazy"
/>

搜索索引:最容易被忽略的死角

Stack 主题的搜索是纯客户端的:构建时生成一个 index.json,浏览器把全部文章的标题、标签、正文摘要拉下来,在本地做匹配。

3000 篇时这个文件会到 2–4MB。用户的搜索框还没用上,流量已经花掉了。

到那个规模,换 Pagefind:

1
pagefind --site public

它在构建后扫描 public/,把索引切成几百个小分片,查询时只下载相关的几片。首次搜索的加载量从 MB 级降到几十 KB,而且索引是压缩过的静态文件,不需要任何服务端。

代价是它只能搜到已经渲染进 HTML 的内容——对博客来说完全够用。

图片托管

正文配图放在文章目录里(page bundle)是最省心的,因为 Hugo 的图片处理只认页面资源。但几千篇 × 每篇几张图,仓库很快就会到 GB 级,git clone 变成一次小型下载。

两种解法:

方案优点代价
对象存储 + image: 写完整 URL仓库干净,CDN 加速依赖外部服务,构建时需要联网抓图
独立图片仓库 + jsDelivr免费 CDN,git 管理国内访问不稳定

如果要长期自托管,第一种更稳;构建机上给 resources.GetRemote 配一个本地缓存目录,冷构建的联网开销就只在第一次发生。

排序:什么时候该改

最后一件小事。默认按日期倒序,但写了几年之后,你可能会想让"常青文章"(教程、入门指南)排在新文章前面。Hugo 支持按自定义权重排序:

1
2
[frontmatter]
    weight = ":default"

在常青文章里写 weight: 10,其余不写,就能把置顶做出来而不影响日期归档。这比手动改 date 干净得多。

规模上来以后,值得优化的顺序是:图片 → 搜索 → 模板 → 构建。构建放最后,因为它本来就快。