选 Hugo 的主要理由是构建速度,但"几千篇"这个量级上,构建从来不是第一个崩的地方。先崩的通常是首页体积、客户端搜索索引,以及图片托管。
构建:几秒的事
Hugo 没有增量构建,每次都是全量。听起来可怕,实际上 3000 篇纯文本的构建时间取决于模板复杂度而不是文章数——大多数时间花在图片处理和模板渲染上,而不是解析 Markdown。
真正会拖慢构建的是这三件事,按影响排序:
- 图片处理。每张封面生成 4 个宽度 × WebP/JPEG 两套 = 8 个文件。3000 篇就是 24000 次编码。这是唯一值得做缓存的地方(Hugo 会自动缓存到
resources/_gen,但 CI 上每次都是冷的)。 - 没有
partialCached的循环内 partial。侧栏、页脚、图标这类与页面无关的片段,在文章循环里逐个调用就是灾难。 - taxonomy 页爆炸。每个标签一页,每个标签的分页再乘一层。标签数量失控时页面数会以乘积增长。
| |
首页体积
如果首页用大卡片封面流,代价是每张卡片都要一张真实图片。6 张卡片 × 每张 ~200KB(1080 宽,WebP)≈ 1.2MB——已经超过一个中文文字页面的合理预算。本站干脆不用封面,首页卡片只有文字,这条账直接归零。
如果以后要加回封面,三条硬约束:
- 封面必须走
srcset,手机上不能下载桌面尺寸; - 首屏之外用
loading="lazy"(主题已默认处理); - 列表页封面宽度上限压到 1080,不要用原图。
| |
搜索索引:最容易被忽略的死角
Stack 主题的搜索是纯客户端的:构建时生成一个 index.json,浏览器把全部文章的标题、标签、正文摘要拉下来,在本地做匹配。
3000 篇时这个文件会到 2–4MB。用户的搜索框还没用上,流量已经花掉了。
到那个规模,换 Pagefind:
| |
它在构建后扫描 public/,把索引切成几百个小分片,查询时只下载相关的几片。首次搜索的加载量从 MB 级降到几十 KB,而且索引是压缩过的静态文件,不需要任何服务端。
代价是它只能搜到已经渲染进 HTML 的内容——对博客来说完全够用。
图片托管
正文配图放在文章目录里(page bundle)是最省心的,因为 Hugo 的图片处理只认页面资源。但几千篇 × 每篇几张图,仓库很快就会到 GB 级,git clone 变成一次小型下载。
两种解法:
| 方案 | 优点 | 代价 |
|---|---|---|
对象存储 + image: 写完整 URL | 仓库干净,CDN 加速 | 依赖外部服务,构建时需要联网抓图 |
| 独立图片仓库 + jsDelivr | 免费 CDN,git 管理 | 国内访问不稳定 |
如果要长期自托管,第一种更稳;构建机上给 resources.GetRemote 配一个本地缓存目录,冷构建的联网开销就只在第一次发生。
排序:什么时候该改
最后一件小事。默认按日期倒序,但写了几年之后,你可能会想让"常青文章"(教程、入门指南)排在新文章前面。Hugo 支持按自定义权重排序:
| |
在常青文章里写 weight: 10,其余不写,就能把置顶做出来而不影响日期归档。这比手动改 date 干净得多。
规模上来以后,值得优化的顺序是:图片 → 搜索 → 模板 → 构建。构建放最后,因为它本来就快。