我用 Hugo + Nginx 搭博客的全过程记录

Sun, 11 Oct 2026 12:14:00 +0800

博客上线前那个晚上，我 hugo server 一跑，页面出来了，但长得不对——素面朝天，明显是 Hugo 的默认脸，我精心挑选的 PaperMod 主题根本没生效。我翻来覆去检查配置文件，三个小时后才发现：网站根目录下躺着两个配置文件，Hugo 读了我没写内容的那份。那天折腾到半夜一点，第二天早上送孩子上学时眼睛都是花的。

下面是我搭这个博客的全过程，顺利的地方三言两语，踩坑的地方细说——毕竟坑才是这篇文章的价值。

装 Hugo：别用 apt，直接下官方包

Ubuntu 的 apt 仓库里有 Hugo，但版本老。我一开始图省事 apt install hugo，装完 hugo version 一看，版本号比 PaperMod 要求的低了一大截。果断卸载，改去 Hugo 官网下载了 extended 版的 deb 包：

sudo dpkg -i hugo_extended_0.x.x_linux-amd64.deb
hugo version

为什么非要 extended 版？PaperMod 的某些功能（比如处理 SCSS 样式）依赖它。普通版装上也能跑，但迟早会在某个功能上翻车，不如一步到位。这个教训的学费，是我卸载重装那十分钟——外加去官网找对应 deb 包时，对着一堆版本号挑花眼的五分钟。认准 hugo_extended 开头、系统架构 linux-amd64 的那个，别下错成 ARM 版（树莓派才用那个）。

加 PaperMod 主题

PaperMod 是 Hugo 生态里很受欢迎的主题，干净、快、对中文友好。用 git submodule 的方式装，方便以后更新：

cd ~/blog
git init
git submodule add https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod

然后在 hugo.toml 里指定主题：

Hugo on OpusMia

我用 Hugo + Nginx 搭博客的全过程记录

装 Hugo：别用 apt，直接下官方包

加 PaperMod 主题