Hugo网站部署giscus评论系统教程2026

大家好，我是彪哥。

说一下我的情况，我的 Hugo 源码仓库是 Private的。

由于 giscus 要求仓库必须公开，我要新建一个公开仓库来存评论。

同时这样的话也比较整洁， GitHub 的 Discussions 讨论区和你网站的源代码、Issue 混在一起。

如果你的 Hugo 源码仓库是公开的，你也可以直接用那个仓库，

不过我这个教程是直接新建一个的，废话不多说，直接开始。

1.建立一个新仓库，并公开

2.开启 Discussions 功能

仓库建好后，进到这个新仓库的主页：

点击顶部的 Settings（设置）。
在左侧菜单选 General（通常默认就是这个）。
向下滚动找到 Features 一栏。
找到 Discussions 并勾选它。这一步做了之后，你仓库顶部会多出一个 “Discussions” 选项卡。

3.然后打开下面的链接，下载giscus

打开https://github.com/apps/giscus

点击 Install下载。

在权限设置页面，选择 “Only select repositories”。

在下拉菜单里搜索并选中你刚才建的那个 blog-comments 仓库。

再点击 install。

输入密码确定

4.现在去 giscus 官网，配置

打开giscus.app

在 “仓库” 栏输入：你的用户名/blog-comments。看到“成功”提示后，继续往下。

“页面 ↔️ Discussion 映射”：选 “Discussion 标题包含页面路径 (pathname)”。就是保持默认的
“分类”：选 Announcements。
剩下的全部保持默认
拿到 ID：向下滚动到 “启用 giscus” 那个灰色的代码框，找到下面的内容并复制出来：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
<script src="https://giscus.app/client.js"
        data-repo=""
        data-repo-id=""
        data-category=""
        data-category-id=""
        data-mapping="pathname"
        data-strict="0"
        data-reactions-enabled="1"
        data-emit-metadata="0"
        data-input-position="bottom"
        data-theme="preferred_color_scheme"
        data-lang="zh-CN"
        crossorigin="anonymous"
        async>
</script>

5.然后直接发给Agent帮你配置

本地测试好了，就可以上线了

6.顺便聊聊

1. 它是啥原理？

说白了，giscus 就是个搬运工。

你不想买服务器，也不想整数据库，那评论存哪儿呢？

GitHub 专门有个叫 Discussions（讨论区）的功能。

giscus 的作用就是：把 GitHub 的讨论区抠下来，像贴纸一样贴到你的博客下面。

别人在你的博客留言，其实是实打实地写在了 GitHub 的讨论区里。

giscus 负责在中间传话，把两边同步。

2. 谁做的？

作者是个英国哥们儿，叫 Sage Abdullah。

这哥们儿觉得以前的同类工具把评论存在 Issue太乱了，毕竟 Issue 是用来修 Bug 的。

于是他趁着 GitHub 刚推出 Discussions 功能，顺手写了这个更清爽、更先进的工具。

2026 年了，这玩意儿依然是目前最火的方案之一。

3.有啥缺点吗？

门槛太高。

因为它直接把评论写在 GitHub 的 Discussions 里，所以读者必须拥有 GitHub 账号才能评论。

对于开发者博客来说可能还好，但对于普通读者来说，不友好。

如果你希望支持匿名评论或者多种社交账号登录，你需要看下面这些方案。

一、Waline (最推荐)

这是目前 Hugo 圈子里非常流行的方案，特别是中文社区。

登录方式：支持匿名、QQ、微信、GitHub、Google 等多种登录。

优点：功能极其强大（支持表情包、文章阅读量统计、邮件通知等），界面好看。

部署：可以利用 Vercel（免费托管）+ LeanCloud/MongoDB（免费数据库）实现 0 成本运行。

如果你想要一个功能最全、门槛最低（支持匿名）的评论系统，选它。

二、 Twikoo

和 Waline 类似，也是一个简洁、高效的评论系统。

三、Cusdis

如果你追求极致的简单，不想折腾各种功能，只要能评论就行。

四、 Artalk

功能比 Waline 还全面，有完整的管理后台，可以像审核论坛一样管理评论。

五.对比

方案	匿名评论	门槛	维护成本	优势
giscus	❌ 不支持	极低	零维护	免费、无后台
Waline	✅ 支持	中	低 (Vercel)	功能最全、支持社交登录
Twikoo	✅ 支持	中	低 (Vercel)	轻量、配置简单
Cusdis	✅ 支持	低	极低	隐私、极其轻量