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

博客上线前那个晚上,我 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 里指定主题: ...

October 11, 2026 · 2 min · 224 words