Hugo PaperMod主题搜索故障求助：缺失index.json文件

核心原因 #

PaperMod的搜索功能依赖Hugo生成的index.json站点索引文件，但默认情况下Hugo可能未开启该输出格式，导致文件未生成，进而引发搜索失效。

具体解决步骤 #

1. 修改站点配置文件（config.yml） #

在你的config.yml中添加或调整outputs配置，确保home输出列表包含JSON格式：

outputs:
  home:
    - HTML
    - RSS
    - JSON  # 新增这一行，触发Hugo生成index.json

如果配置文件中已有outputs节点，直接在home数组内追加JSON即可。

2. 本地验证生成结果 #

运行hugo命令构建站点，然后检查项目根目录下的public文件夹，确认是否生成了index.json文件。

3. 部署环节注意点 #

• 确保部署工具（如Netlify、Vercel）完整上传public目录下的所有文件，不要过滤.json后缀的文件。
• 若用Git部署，检查.gitignore是否排除了public目录，若有则需调整规则，或者确保部署时重新执行构建命令生成完整文件。

补充说明 #

PaperMod主题的搜索功能默认会自动读取站点根目录下的index.json，无需额外配置主题参数，只要Hugo正确生成该文件，搜索即可正常工作。

内容的提问来源于stack exchange，提问作者mfaani