告别 PaperMod:审美疲劳后的 Hugo 博客“换装”记
记录一次从 PaperMod 迁移到 pehtheme-hugo 的心路历程,以及如何利用 AI 修复一个半成品主题。
- 老刘
- 1 min read
在 Hugo 的世界里,PaperMod 绝对称得上是“国民级”主题。它简洁、高效、功能完备,我也用了好几年。但正如所有长久的相处都会走向平淡,用了几年后,那种视觉上的倦怠感扑面而来。
这段时间,我一直在 Hugo Themes 库里反复打量,却始终没有找到那种“一眼万年”的感觉。直到有一天,我逛到了 eallion 的博客,看到他完善了一款名为 pehtheme-hugo 的主题。
遇见新欢:pehtheme-hugo
eallion 完善的这个版本已经非常出色,并且在 GitHub 上开源了。第一眼看到它,我就觉得这正是我想找的风格。
不过,为了避免直接“撞衫”的尴尬,我没有直接克隆他那套高度定制的版本,而是决定从原始版本开始,自己动手,丰衣足食。
“半成品”的磨难与 AI 的救赎
原始版的 pehtheme-hugo 其实更像是一个半成品。虽然骨架很漂亮,但内部细节却让人头大:
- 搜索功能:完全是摆设,点不开也搜不到。
- 图片引用:路径处理逻辑有误,很多地方的图片引用都是错的。
- 页面缺失:核心的归档页、友链页、评论系统几乎是一片空白。
如果是以前,作为一个代码小白,面对这些问题我可能就直接劝退了。但现在是 AI 时代,只要有想法,剩下的都可以交给“赛博劳动力”。
我的折腾流程:iflow cli + AI
我利用 iflow cli 配合 AI,开始了一场针对主题的“大手术”。
操作心得: 以前需要翻遍文档、折腾好几天的难题,现在通过与 AI 的对话,让AI直接修改生成原貌,全程不用自己动手,这个感觉还是很爽的。
- 修复搜索:重新梳理了 JSON 索引逻辑,现在搜索功能终于活了。
- 页面增建:逐一补全了归档、友情链接以及评论系统的模板代码。
- 细节微调:把原本那些看着不顺眼的 CSS 样式逐个修正,让它更符合我的审美。

现状与未来
目前博客已经基本成型,虽然还有很多可以完善的空间,但至少“能用了”。
这就像是刚装修完的房子,大件家具都进场了,至于那些装饰性的软装,等以后哪天看哪里不顺眼了再改吧。折腾的意义不在于追求绝对的完美,而在于那种“把想法变成现实”的掌控感。