静态站生成器横评:Hugo、Astro、Eleventy 与自写脚本
从构建速度、模板语法、学习曲线、生态四个维度比较主流静态生成器,并说明什么时候自己写一个反而更省事。
静态站生成器的本质是「把模板 + 数据编译成 HTML」。不同工具的差别,在于模板语法有多重、构建有多快、生态有多大。
四个候选的真实差异
| 工具 | 语言 | 构建速度 | 学习曲线 | 适合 |
|---|---|---|---|---|
| Hugo | Go | 极快,千页几秒 | 中,模板语法需适应 | 内容量大、更新频繁 |
| Astro | JS/TS | 中 | 低,接近写 HTML | 需要组件化、局部交互 |
| Eleventy | JS | 快 | 低,模板格式自由 | 内容站、可控性优先 |
| 自写 Python/Node 脚本 | 任意 | 取决于实现 | 取决于你 | 结构固定、页面模式统一 |
Hugo:快是最大的功能
Hugo 单二进制、无依赖,一万篇文章的站点构建通常在十秒级。它的模板语法(Go template)对新手不友好,但一旦熟悉,组合能力很强。适合新闻、文档、大型内容库。
坑在于:Hugo 的版本升级偶发破坏模板行为,锁定版本、把主题当代码管理是必要的。
Astro:组件化与「零 JS 默认」
Astro 的核心卖点是默认输出零 JavaScript,需要交互的组件才「岛屿式」加载。对一个以内容为主的站,这意味着首屏几乎没有 JS 阻塞。
它的 .astro 语法接近 JSX + HTML,前端背景的人上手最快。缺点是构建产物与依赖链比纯静态复杂,长期维护需要 Node 环境。
Eleventy:把控制权还给你
Eleventy 不规定模板语言,Markdown、Nunjucks、Liquid、HTML 都能混用。它的哲学是「少抽象」,适合不想被框架绑定的团队。配置写在 .eleventy.js 里,数据用目录结构组织,直观。
缺点是生态小,很多功能要自己写 shortcode 或 filter。
自写脚本:被低估的选项
如果站点结构固定——比如「首页 + 5 个栏目 + 文章列表 + 文章详情」——用 200 行 Python 生成器,往往比引入一个框架更快、更可控。优点是:
- 模板就是字符串拼接,改样式不用查文档
- 数据就是 Python 列表,写内容像写代码
- 没有依赖升级问题,三年后还能跑
- 构建 100 页在 1 秒内
缺点是没有现成的分页、标签、RSS,需要自己实现。对一个 50–200 页的站,这些功能加起来不超过 300 行。
怎么选:三个问题
- 文章超过 1000 篇吗? 是 → Hugo
- 需要组件复用和局部交互吗? 是 → Astro
- 团队只有后端或运维吗? 是 → 自写脚本或 Eleventy
与部署的配合
静态站的部署极简:构建产物是一堆文件,同步到 nginx 的 root 目录即可。发布流程可以是 rsync、Git hook,或者一条 tar | ssh 命令。
注意:不要用 cat file | ssh "cat > /tmp/x" 传大文件,连接抖动时会静默截断,解压出旧内容且极难察觉。用 scp 或 rsync,并在两端比对 md5sum。
部署细节见nginx 配置入门。