635 字
2 分钟
Giscus 评论系统配置教程
Giscus 评论系统配置教程
简介
Giscus 是一个基于 GitHub Discussions 的开源评论系统。访客借助 GitHub 账号即可在网站上发表评论，所有数据以 Discussions 形式保存在你自己的公开仓库中，免费、无后台、易于迁移。
TIP与 Twikoo、Waline 等需要自建后端的方案不同，Giscus 完全依赖 GitHub，无需额外的数据库或服务。
前置条件
启用 Giscus 前，请确保满足以下条件：
- 拥有一个 公开（Public） 的 GitHub 仓库，用于存放评论。
- 在该仓库的 Settings → General → Features 中启用 Discussions 功能。
- 安装 giscus GitHub App 并授予其对目标仓库的访问权限。
- 该仓库已开启 Actions（Giscus 的搜索依赖仓库内的 workflow，通常默认开启）。
前往 Giscus 配置
打开 Giscus 官网（中文），按页面引导填写：
- 仓库：填写
owner/repo形式，例如cui123666/blog。 - 页面 ↔ Discussion 映射：选择“Discussion 的标题包含页面 pathname”（推荐）或其他映射方式。
- Discussion 分类：选择一个已存在的分类（如 General），新评论会创建到该分类下。
- 特性：按需开启“启用反应”、“启用发帖前登录提示”等。
- 主题与语言：选择喜欢的配色（如
preferred_color_scheme跟随系统）与界面语言。
填写完成后，页面会自动生成一段 <script> 嵌入代码。
嵌入参数说明
生成的脚本大致如下，各参数含义：
<script src="https://giscus.app/client.js" data-repo="owner/repo" data-repo-id="R_kgDXXXXXXX" data-category="Announcements" data-category-id="DIC_kwDOXXXXXX" 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>| 参数 | 说明 |
|---|---|
data-repo | 评论存放的公开仓库（owner/repo） |
data-repo-id | 仓库 ID（Giscus 配置页自动生成） |
data-category | 评论映射到的 Discussion 分类名称 |
data-category-id | 分类 ID（自动生成） |
data-mapping | 页面与 Discussion 的关联方式（pathname、url、title 等） |
data-reactions-enabled | 是否显示表情反应（1 开启） |
data-theme | 主题配色，可填 light/dark/preferred_color_scheme 等 |
data-lang | 界面语言，如 zh-CN |
如何嵌入网站
将上方生成的 <script> 放到页面需要展示评论的位置即可（以原生 HTML 为例）：
<section id="comments"> <script src="https://giscus.app/client.js" data-repo="owner/repo" data-repo-id="R_kgDXXXXXXX" data-category="Announcements" data-category-id="DIC_kwDOXXXXXX" 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></section>NOTE在基于框架的站点（如 Astro、Hexo、VuePress）中，通常把该脚本封装成一个评论组件，并在文章页统一引入。具体集成方式取决于你的博客主题与评论配置（例如本博客当前评论系统为 Twikoo，可参考对应配置项替换）。
祝你天天开心！
部分信息可能已经过时