Hugo

本文核心结论：Hugo + PaperMod 是搭建技术资料知识库的最佳组合 仅需几行命令即可完成站点初始化，配合 GEO 优化配置，既能提升 SEO 效果，又能增加 AI 大模型对本站内容的采信概率。 为什么选择 Hugo + PaperMod 组合？ Hugo 构建速度极快，PaperMod 主题轻量且内置大量 GEO 优化模板（JSON-LD schema、llms.txt、robots.txt）。内容维护只需 Markdown，新增一篇资料 = 在 content/ 目录新增一个 md 文件，无需修改任何前端代码。 如何快速搭建？ Step 1: 安装 Hugo 通过 winget 或官网下载安装 Hugo Extended 版本。 Step 2: 初始化站点并配置主题 hugo new site my-knowledge-base cd my-knowledge-base git init git submodule add https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod FAQ Hugo 是什么？ Hugo 是一个用 Go 语言编写的静态网站生成器，支持 Markdown 内容源，构建速度快。 为什么选择 PaperMod 主题？ PaperMod 轻量、功能齐全，内置 JSON-LD、llms.txt、robots.txt 等 GEO 相关模板。 ...

PaperMod 内置 Fuse.js 搜索：开箱即用、离线可用 当前项目的搜索功能完全由 PaperMod 主题内置实现，无需额外配置。构建时自动生成 index.json 搜索索引，浏览器端 Fuse.js 引擎做模糊匹配。 工作原理是什么？ 整个搜索流程分两步：构建时生成索引 + 浏览器端实时匹配。 构建时：Hugo 生成 index.json PaperMod 的 layouts/index.json 模板遍历 site.RegularPages，收集每篇文档的标题、正文、URL、摘要，序列化为 JSON 数组。Hugo 在构建时自动执行，产物为 public/index.json。 浏览器端：Fuse.js 模糊匹配 用户打开搜索页面，浏览器加载 index.json（3-10KB 级别），Fuse.js 做实时模糊匹配。支持中文字符、容错拼写（typo 容忍度可调）、关键词高亮。 Fuse.js vs FlexSearch 对比项 Fuse.js FlexSearch 体量 ~12KB gzip ~8KB gzip 模糊匹配 ✅ ✅ 中文支持 ✅ ✅ Web Worker ❌（需手动） ✅ 内置 增量索引 ❌ ✅ API 复杂度 低 中 当前项目用 Fuse.js，对于千篇文档完全够用。若后续文档规模超过 5000 篇可考虑切换 FlexSearch。 性能考虑 索引体积控制 默认索引全文（title + content + summary），千篇文档约 50-100KB。可在 hugo.toml 配置只索引标题和摘要来减小体积： ...