Hugo 建站 5 大使用场景 - 2026 整站源码实战指南，含 5 大关键点 + 自查清单 + 速查手册，新手必学。
# Hugo 建站 5 大使用场景
Hugo 是 Go 写的静态站点生成器，1000 篇文章 < 5 秒编译完，是 Hexo / Jekyll 速度的 10-30 倍。本文讲 Hugo 5 大典型使用场景。
第 1 招：判断标准（用不用 Hugo）
3 个判断标准：
1. 文章数 > 500 → Hugo 是首选
2. 追求极致速度 → Hugo 编译最快
3. 团队用 Go 生态 → Hugo 是 Go 写的
速度对比（1000 篇文章 / i5-8250U）：
| 平台 | 编译时间 | 首屏 |
|---|---|---|
| Hugo | 5 秒 | 0.3 秒 |
| Hexo（优化） | 20 秒 | 0.5 秒 |
| Jekyll | 60 秒 | 0.8 秒 |
第 2 招：避坑点（Go 模板 + 主题）
1. Go 模板语法：跟 Jekyll / Hexo 不同（`{{ .Title }}`）
2. 主题用 git submodule 装：改主题得进 submodule 改
3. 中文文件名：必须用 `--metaDataFormat yaml`
4. 版本升级：Hugo 0.x → Hugo 1.x API 大改
第 3 招：关键参数（速度对比）
| 文章数 | Hugo | Hexo | Jekyll |
|---|---|---|---|
| 100 | 0.5 秒 | 5 秒 | 10 秒 |
| 500 | 2 秒 | 12 秒 | 30 秒 |
| 1000 | 5 秒 | 20 秒 | 60 秒 |
| 5000 | 20 秒 | 200 秒 | 300 秒 |
第 4 招：易踩坑（submodule + 部署）
```bash
# 安装主题（必须用 submodule）
git submodule add https://github.com/adityatelange/hugo-PaperMod themes/PaperMod
# 本地预览
hugo server -D
# 编译输出（输出到 public/）
hugo
# 部署到 GitHub Pages
git push origin main
```
4 个易踩坑：
1. 不要推 `public/` 到 main 分支（让 Actions 编译）
2. 必须用 `hugo --minify`（HTML 压缩）
3. 必须配 `baseURL`（不然首页资源 404）
4. 必须装 `hugo-extended`（支持 Sass）
第 5 招：场景建议（5 大场景）
| 场景 | Hugo 主题 | 部署 |
|---|---|---|
| 个人博客 | PaperMod / LoveIt | GitHub Pages |
| 技术博客 | Stack / Terminal | Vercel |
| 作品集 | Portfolio / Rotate | Cloudflare Pages |
| 文档站 | Docsy / Doks | Netlify |
| 团队博客 | hello-friend | GitHub Pages |
下载包里有什么
[Hugo 5 大使用场景速查 PDF]：6 页速查
[Hugo 场景速查.md]：5 大场景 + 6 款主题推荐
[Hugo 主题对比.md]：6 款热门主题实测对比
[hugo推荐配置.toml]：完整推荐配置
为什么必须下载
Hugo 主题网上资料多但完整配置少，下载包提供完整 Hugo TOML 配置 + 6 款主题实测对比 + 5 大场景选型决策。按这个配置 5 分钟搭好一个 Hugo 站。
本文配套下载包按 4 件套打包：PDF 速查手册 + Hugo 场景速查 + Hugo 主题对比 + Hugo 推荐配置。打开即用。
