Hugo静态博客中添加评论功能
内容提要
本文介绍了如何在Hugo静态博客中添加Giscus评论功能。Giscus是基于GitHub Discussions的开源评论系统，支持多种语言和自定义主题。安装步骤包括选择仓库、启用Discussions、生成配置并在博客模板中引入相关代码。这样，访客可以在博客下方评论，作者也能在GitHub上管理评论。
延伸解读
为什么选择 Giscus 而非其他评论系统
作者在 Disqus、Twikoo、Valine、Utterances 等方案中最终选择了 Giscus，主要因为其与 GitHub Pages 的天然联结。Giscus 开源、无广告、永久免费，且无需数据库，所有评论数据都存储在 GitHub Discussions 中。对于使用 GitHub 托管博客的开发者来说，这种集成方式既降低了维护成本，也避免了第三方服务可能带来的隐私和广告问题。
Giscus 的工作原理与访客评论流程
Giscus 利用 GitHub Discussions 作为评论存储后端。当页面加载时，它会通过 GitHub Discussions 搜索 API 根据配置的映射方式（如 URL、pathname）查找关联的 discussion。若不存在，则会在首次有人评论时由 giscus bot 自动创建。访客评论需通过 GitHub OAuth 授权 giscus app 代表其发帖，也可直接在 GitHub Discussion 中评论，作者则能在 GitHub 上统一管理。
安装配置的关键步骤与注意事项
安装 Giscus 需先选择一个仓库（通常就用博客本身的仓库），在仓库设置中启用 Discussions，然后在 Giscus 官网生成配置。接着将配置信息填入 Hugo 的配置文件（如 config.toml 或 params.toml），并在评论模板中引入 giscus.html。注意不同主题的变量命名可能不同，需参考主题文档。若某篇文章不想开启评论，可在其 Markdown 文件头部添加 comments: false。
Q&A
Giscus是什么？
Giscus是基于GitHub Discussions的开源评论系统，支持多种语言和自定义主题。
如何在Hugo博客中安装Giscus评论功能？
安装Giscus的步骤包括选择仓库、启用Discussions、生成配置并在博客模板中引入相关代码。
使用Giscus评论需要什么条件？
访客需要通过GitHub OAuth流程授权Giscus应用才能评论。
Giscus的评论数据存储在哪里？
所有评论数据均储存在GitHub Discussions中，无需数据库。
如果不想在某篇文章中开启评论功能，该怎么做？
可以在文章的Markdown文件头部添加comments: false来禁用评论功能。
Giscus的主要优势是什么？
Giscus的优势包括开源、无广告、永久免费、无需数据库和高度可配置性。
