在 Hugo 官方主题库中，PaperMod 长期占据着最受欢迎的位置。截至 2026 年，它在 GitHub 上的 Star 数超过 15,000，被数万个个人博客和文档站点使用。这篇文章来分析它为什么能获得如此广泛认可。

设计哲学：做减法而非加法

PaperMod 的核心设计理念是"克制"。它不追求功能的大而全，而是专注于把博客最核心的需求做好：

  • 阅读体验优先：单栏布局，宽窄适中的内容区域（约 720px），配合合适的字体大小和行高，让长文阅读不疲劳
  • 视觉噪音最小化：没有花哨的动画、没有多余的装饰元素，让读者的注意力集中在内容上
  • 主题切换自然：支持自动跟随系统、手动切换浅色/深色模式，过渡平滑

性能：快得几乎无感

PaperMod 在性能方面做了大量细致的工作：

  1. 零外部依赖：不引入任何第三方 CSS 框架或 JS 库（搜索功能可选 fuse.js）
  2. CSS 变量驱动：主题色、间距、字体等全部使用 CSS 变量，方便定制且不会产生冗余样式
  3. 按需加载：搜索 JS、评论系统等仅在需要时加载
  4. 资源最小化：Hugo 内置的 asset pipeline 自动压缩和指纹化静态资源

实际测试中，PaperMod 构建的站点 Lighthouse 得分通常在 95-100 分之间。

SEO：开箱即用的搜索引擎优化

PaperMod 内置了完善的 SEO 支持：Open Graph、Twitter Cards、JSON-LD 结构化数据、Canonical URL、robots.txt、RSS 等。PaperUI 完全继承了这些能力。

详细的 SEO 优化实践请参考 PaperUI 的 SEO 优化实践指南。

多语言支持

PaperMod 内置了 46 种语言的翻译文件，从英语、中文到阿拉伯语（RTL）都有覆盖。多语言站点的切换体验流畅自然。

开发者友好

  • 配置驱动：几乎所有功能都通过 hugo.toml 参数控制，不需要修改模板代码
  • 扩展点丰富：extend_head.html、extend_footer.html 等扩展模板，可以无侵入地添加自定义代码
  • 完善的文档：官方 Wiki 覆盖了从安装到高级定制的方方面面

活跃的社区

PaperMod 的 GitHub Issues 和 Discussions 非常活跃，作者 Aditya Telange 响应迅速。大量用户贡献了使用案例、配置技巧和问题解答，形成了良好的社区生态。

不足之处

客观地说，PaperMod 也有一些局限：

  • 首页信息密度较低：标准模式首页只有一个简单的欢迎信息和文章列表
  • 缺少侧边栏：没有分类、标签等导航小部件
  • 移动端体验一般：没有针对移动端的专门导航优化
  • 中文场景适配不足：部分 UI 文案、日期格式等不够本地化

这些正是 PaperUI 要解决的问题。下一篇我们将详细讨论，为什么要基于 PaperMod 做二次开发，以及 PaperUI 具体做了哪些改进。