Blowfish主题启用Utterances评论遇警告，求含义及同类问题经验

警告含义 #

这个警告的意思很明确：你已经为post/fb-community/index.md这篇文章开启了评论功能，但Blowfish主题找不到对应的评论模板文件（也就是文档中提到的comments partial）。简单来说就是「开了评论开关，但没放评论功能的实现代码文件」。

是否有其他用户遇到？ #

当然有，这是配置Utterances评论时的常见问题，大多是文件路径、命名或配置项出错导致的，常见诱因包括：

• 未在站点根目录的layouts/partials/comments/路径下创建utterances.html文件
• 文件名拼写错误（比如写成utterence.html，或是大小写不匹配，Hugo对文件名大小写敏感）
• 配置文件里的评论提供者设置错误，比如把params.comments.provider设为utterances，但没对应创建模板文件
• 误将模板文件放在了主题文件夹的layouts目录下，而非站点根目录的layouts（如果是通过子模块使用主题，应在站点根目录创建对应路径来覆盖主题设置）

解决建议 #

• 先确认站点根目录下存在layouts/partials/comments/utterances.html，文件内要包含Utterances的嵌入代码（按Blowfish文档示例编写即可）
• 检查配置文件（如config.toml）：确保[params.comments]区块下provider = "utterances"，同时填好repo等必填配置项
• 核对文件名：必须是utterances.html，和配置里的provider名称完全一致
• 若通过子模块使用Blowfish主题，不要修改主题文件夹内的文件，所有自定义模板都要放在站点根目录的layouts对应路径下

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