https://hugo-theme-imx.vercel.app/tags/github-discussions/Recent content in GitHub Discussions on IMX 示例站Hugozh-CNWed, 15 Jul 2026 10:00:00 +0800https://hugo-theme-imx.vercel.app/posts/imx-giscus-comments/Wed, 15 Jul 2026 10:00:00 +0800https://hugo-theme-imx.vercel.app/posts/imx-giscus-comments/<p>Giscus 不替你另建一套评论数据库。每篇文章的评论最终都是 GitHub Discussions 里的一个讨论，访客用 GitHub 账号登录后发言，站长仍在熟悉的仓库里管理内容。对静态博客来说，这套办法省心，也方便迁移。</p> <p><img src="https://hugo-theme-imx.vercel.app/posts/imx-giscus-comments/images/cover.webp" alt="IMX 主题与 Giscus 评论连接示意" width="1600" height="900" loading="lazy" decoding="async"></p> <p>IMX 已经把 Giscus 的加载、懒加载和深浅色同步写进主题。真正需要做的事只有两部分：先把 GitHub 仓库准备好，再把 giscus.app 生成的参数原样填进 <code>hugo.toml</code>。</p> <h2 id="开始前先选好评论仓库">开始前先选好评论仓库</h2> <p>评论可以放在博客源码仓库，也可以单独建一个仓库。个人站点我更倾向于单独建，例如 <code>your-name/blog-comments</code>：源码仓库的 Issues、Pull Requests 和 Discussions 不会混在一起，将来更换静态站点生成器，也不影响旧评论。</p> <p>无论选哪一种，仓库都要满足三个条件：</p> <ol> <li>仓库是公开仓库。Giscus 需要让访客读取讨论内容。</li> <li>仓库已经启用 GitHub Discussions。</li> <li>Giscus GitHub App 已获准访问这个仓库。</li> </ol> <p>若仓库属于组织，安装 GitHub App 可能需要组织所有者批准。不要等到配置页一直报错才回头查权限。</p> <h2 id="第一步开启-github-discussions">第一步：开启 GitHub Discussions</h2> <p>进入评论仓库，依次打开 <strong>Settings → General → Features</strong>，勾选 <strong>Discussions</strong>。仓库顶部随后会出现 <strong>Discussions</strong> 标签。</p> <p>第一次进入 Discussions 时，GitHub 会让你选择或创建讨论分类。IMX 示例配置使用 <code>Announcements</code>，但这不是硬性要求。你可以新建一个名为“博客评论”的分类，只要稍后在 giscus.app 里选择同一个分类即可。</p> <p>建议把分类的格式设为 <strong>Open-ended discussion</strong>。如果使用公告类分类，还要确认普通访客能够在对应讨论下回复。</p> <h2 id="第二步安装-giscus-app">第二步：安装 Giscus App</h2> <p>打开 <a href="https://github.com/apps/giscus">Giscus App 安装页</a>，点击 <strong>Install</strong>，选择仓库所属的个人账号或组织。</p>