用 Hugo 搭博客这事儿，我折腾了三遍才搞明白

说实话，第一次听说 Hugo 的时候我还以为是那个赛车游戏……

那是2023年的事儿了。当时我的 WordPress 博客越跑越慢，服务器配置也不高，打开一篇文章要转三四秒。朋友推荐说换 Hugo 吧，静态网站，飞一样快。我想着，行啊，试试就试试。

结果第一遍折腾了两天，放弃了。原因是——主题太难搞。我选了个看起来很漂亮的主题，下载下来一看，配置文件一堆，什么 params.toml、config.yaml，还有短代码、自定义 CSS……直接劝退。

第二遍是半年后。这次我学乖了，直接选了最基础的 ananke 主题，官方文档里第一个例子就是它。照着走了一遍 Quick Start，居然真的跑起来了！本地服务器一开，hugo server 敲下去，浏览器打开 localhost:1313，页面出来了——虽然丑了点，但至少能看。

真正让我坚持下来的原因其实很俗：速度。我那台腾讯云最便宜的轻量服务器，之前跑 WordPress，内存常年占用 80% 以上。换成 Hugo 之后？静态文件，连数据库都不需要，内存占用直接掉到 20%。

不过话说回来，Hugo 也不是没有坑。

最大的坑是中文内容的中文路径问题。早期版本里，如果你的文章标题是中文，生成的 URL 有时候会乱码。后来我干脆统一用英文 slug，比如 slug: "hugo-setup-guide"，这个问题就没了。

还有就是评论系统。静态网站嘛，本身不带评论功能。我试过 Disqus，加载慢得要死，还满屏广告。最后换了 Waline，自己部署，干净多了。顺带一提，Waline 的部署文档写得挺烂的，我踩了不少坑才跑起来，有机会专门写一篇。

对了，如果你也想试试 Hugo，我的建议是：

• 别一上来就追求完美，先让网站跑起来
• 主题选简单的，别被花里胡哨的功能迷惑
• 写几篇真实内容再考虑美化，不然很容易陷入"一直在折腾主题，从来没写过文章"的死循环

我现在这个博客就是用 Hugo 搭的，从2024年跑到现在，没出过任何问题。有时候我甚至觉得，它太稳定了，稳定到让我忘了它的存在——这大概就是好工具的标准吧。

如果你在搭建过程中遇到什么问题，欢迎留言，我知道那种对着报错信息发呆的感觉……

标签： Hugo 博客 搭建