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

大家好，我是彪哥。
说一下我的情况，我的 Hugo 源码仓库是 Private的。
由于 giscus 要求仓库必须公开，我要新建一个公开仓库来存评论。
同时这样的话也比较整洁， GitHub 的 Discussions 讨论区和你网站的源代码、Issue 混在一起。
如果你的 Hugo 源码仓库是公开的，你也可以直接用那个仓库，
不过我这个教程是直接新建一个的，废话不多说，直接开始。
## 1.建立一个新仓库，并公开

![image-20260401212253323](https://developer.qcloudimg.com/http-save/yehe-12189619/ccb710163607c578fefb36c070a5ee9e.webp)
## 2.开启 Discussions 功能

仓库建好后，进到这个新仓库的主页：
1. 点击顶部的 Settings（设置）。
2. 在左侧菜单选 General（通常默认就是这个）。
3. 向下滚动找到 Features 一栏。
4. 找到 Discussions 并勾选它。这一步做了之后，你仓库顶部会多出一个 "Discussions" 选项卡。

![image-20260401212404818](https://developer.qcloudimg.com/http-save/yehe-12189619/725430303de51fcb3e4a8be6dcf74957.webp)
## 3.然后打开下面的链接，下载giscus

打开https://github.com/apps/giscus 
![image-20260401214058760](https://developer.qcloudimg.com/http-save/yehe-12189619/76cbd7bed188026488712b123c12e490.webp)点击 Install下载。
在权限设置页面，选择 "Only select repositories"。
在下拉菜单里搜索并选中你刚才建的那个 `blog-comments` 仓库。
再点击 install。
![image-20260401214207233](https://developer.qcloudimg.com/http-save/yehe-12189619/799ca2648c00220383ac955b566a6932.webp)

输入密码确定
![image-20260401214436332](https://developer.qcloudimg.com/http-save/yehe-12189619/3a83e4129434f79de764afb01d2c49eb.webp)


## 4.现在去 giscus 官网，配置

打开[giscus.app](https://giscus.app/zh-CN) 
1. 在 “仓库” 栏输入：`你的用户名/blog-comments`。看到“成功”提示后，继续往下。

![image-20260401215240809](https://developer.qcloudimg.com/http-save/yehe-12189619/f8ddd679a92c979a16ea7a6f7f801b39.webp)
1. “页面 ↔️ Discussion 映射”：选 “Discussion 标题包含页面路径 (pathname)”。就是保持默认的
	![image-20260401215321859](https://developer.qcloudimg.com/http-save/yehe-12189619/48e6f6b6f43d6f1977d0aab346e4f270.webp)
2. “分类”：选 Announcements。
	![image-20260401215407236](https://developer.qcloudimg.com/http-save/yehe-12189619/a834e1ed2a1e5e42a92d7b2603171702.webp)
3. 剩下的全部保持默认
4. 拿到 ID：向下滚动到 “启用 giscus” 那个灰色的代码框，找到下面的内容并复制出来：

![image-20260401215536509](https://developer.qcloudimg.com/http-save/yehe-12189619/2eded2091267d2059bed149caa43e8ed.webp)
```
<script src="https://giscus.app/client.js"
 &nbsp; &nbsp; &nbsp;  data-repo=""
 &nbsp; &nbsp; &nbsp;  data-repo-id=""
 &nbsp; &nbsp; &nbsp;  data-category=""
 &nbsp; &nbsp; &nbsp;  data-category-id=""
 &nbsp; &nbsp; &nbsp;  data-mapping="pathname"
 &nbsp; &nbsp; &nbsp;  data-strict="0"
 &nbsp; &nbsp; &nbsp;  data-reactions-enabled="1"
 &nbsp; &nbsp; &nbsp;  data-emit-metadata="0"
 &nbsp; &nbsp; &nbsp;  data-input-position="bottom"
 &nbsp; &nbsp; &nbsp;  data-theme="preferred_color_scheme"
 &nbsp; &nbsp; &nbsp;  data-lang="zh-CN"
 &nbsp; &nbsp; &nbsp;  crossorigin="anonymous"
 &nbsp; &nbsp; &nbsp;  async>
</script>
```## 5.然后直接发给Agent帮你配置

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

## 6.顺便聊聊

### **1. 它是啥原理？**

说白了，giscus 就是个搬运工。
你不想买服务器，也不想整数据库，那评论存哪儿呢？
GitHub 专门有个叫 Discussions（讨论区） 的功能。
giscus 的作用就是：把 GitHub 的讨论区抠下来，像贴纸一样贴到你的博客下面。
别人在你的博客留言，其实是实打实地写在了 GitHub 的讨论区里。
giscus 负责在中间传话，把两边同步。
### **2. 谁做的？**

作者是个英国哥们儿，叫 Sage Abdullah。
这哥们儿觉得以前的同类工具把评论存在 Issue太乱了，毕竟 Issue 是用来修 Bug 的。
于是他趁着 GitHub 刚推出 Discussions 功能，顺手写了这个更清爽、更先进的工具。
2026 年了，这玩意儿依然是目前最火的方案之一。

![image-20260401215120008](https://developer.qcloudimg.com/http-save/yehe-12189619/fa943dfcc17b6e561f60dd8076fb6cc4.webp)


### 3.有啥缺点吗？

门槛太高。
因为它直接把评论写在 GitHub 的 Discussions 里，所以读者必须拥有 GitHub 账号才能评论。
对于开发者博客来说可能还好，但对于普通读者来说，不友好。
如果你希望支持 匿名评论 或者 多种社交账号登录，你需要看下面这些方案。
### 一、Waline (最推荐)

这是目前 Hugo 圈子里非常流行的方案，特别是中文社区。
登录方式：支持匿名、QQ、微信、GitHub、Google 等多种登录。
优点：功能极其强大（支持表情包、文章阅读量统计、邮件通知等），界面好看。
部署：可以利用 Vercel（免费托管）+ LeanCloud/MongoDB（免费数据库）实现 0 成本运行。
如果你想要一个功能最全、门槛最低（支持匿名）的评论系统，选它。
### 二、 Twikoo

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

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

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


----
### 五.对比


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


----
## 7.总结一下

如果你只是想让大家能随口留个言，不用注册账号：去试试 Waline。
虽然配置起来比 giscus 稍微复杂一点点（需要多弄一个数据库），但它的用户体验是最好的。
如果你想坚持“白嫖”到底且不想维护任何后端：那只能接受 giscus 的 GitHub 登录限制。
其实对于技术博客，要求 GitHub 登录反而能过滤掉很多低质量的灌水评论。
![抱拳了](https://developer.qcloudimg.com/http-save/yehe-12189619/bdb419006352dab1b74edda4c15ec5f6.gif)
>感谢各位朋友捧场！要是觉得内容有点用，**别客气，点赞、在看、转发，直接安排上！**
想以后第一时间看着咱的文章，**别忘了点个星标⭐，别到时候找不着了。**
行了，今儿就到这儿。
**论成败，人生豪迈，我们下期再见！**

大家好，我是彪哥。说一下我的情况，我的 Hugo 源码仓库是 Private的。由于 giscus 要求仓库必须公开，我要新建一个公开仓库来存评论。同时这样的话也比较整洁， GitHub 的 Discussions 讨论区和你网站的源代码、Issue 混在一起。如果你的 Hugo 源码仓库是公开的，你也可以直接用那个仓库，不过我这个教程是直接新建一个的，废话不多说，直接开始。

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

前端

开发工具

Hugo网站部署giscus评论系统详细教程，包含新建GitHub公开仓库、开启Discussions功能、安装giscus应用及配置方法。对比Waline、Twikoo等主流评论系统优缺点，帮助开发者选择最适合的解决方案。适合技术博客站长参考，实现零成本评论功能。

数据库

服务器

MongoDB

GitHub

Agent

2026采购季 | AI焕新·智启新局

tencentdb-catalog

腾讯云数据库特惠，新用户首单0.5折起


mongodb

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Hugo网站部署giscus评论系统教程2026-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐