Giscus Key 获取教程：repo-id 与 category-id 完整配置指南

一、什么是 Giscus Key？

在使用 Giscus 作为评论系统时，需要用到两个关键参数：

data-repo-id
data-category-id

这些通常被称为 Giscus key。

它们的作用是：

标识你的 GitHub 仓库
指定评论所使用的 Discussion 分类

二、获取 Giscus Key 的完整步骤

1. 准备工作

在开始之前，需要确保以下条件已经满足：

拥有一个 GitHub 公共仓库
已安装 Giscus App

安装地址：
https://github.com/apps/giscus

安装时需要选择对应仓库并授权。

2. 打开配置页面

访问 Giscus 官方配置工具：

https://giscus.app/zh-CN

3. 输入仓库信息

在页面中填写：

username/repo

例如：

hezongcheng/blog

⚠️ 这一步必须成功解析，否则不会生成 key。

4. 等待自动加载（关键步骤）

当仓库输入正确后，页面会自动：

拉取仓库信息

加载 Discussions 分类

生成 repo-id

此时你应该能看到类似：

data-repo-id="R_kgDOxxxx"

5. 选择 Discussion 分类

在页面中的分类下拉框选择一个分类，例如：

General

Announcements

选择后系统会自动生成：

data-category-id="DIC_kwDOxxxx"

6. 获取自动生成的 Key（重点）

向下滚动页面底部，你会看到一段自动生成的代码：

<script src="https://giscus.app/client.js"
        data-repo="username/repo"
        data-repo-id="R_kgDOxxxx"
        data-category="General"
        data-category-id="DIC_kwDOxxxx"
        async>
</script>

👉 这里的：

data-repo-id
data-category-id

就是你需要的 Giscus key

三、核心结论

👉 Giscus 的 key 不是手动获取的

👉 而是通过官方页面 自动生成的 script 中提取

四、常见问题与排查

如果你选择了分类但没有生成 key，通常是以下原因：

1. 未登录 GitHub

需要在页面右上角登录 GitHub 账号。

2. 未安装 Giscus App

必须安装并授权仓库。

3. 未开启 Discussions

进入仓库：

Settings → Features → Discussions ✔

4. 没有创建分类

需要至少一个分类：

Discussions → Categories → 新建

5. 仓库不是 Public

Giscus 只支持公开仓库。

6. 权限不足

需要是：

仓库 owner

或 collaborator

五、补充说明

Giscus 的本质是：

👉 使用 GitHub Discussions 作为评论系统

因此：

repo-id → 仓库内部 ID
category-id → Discussion 分类 ID

六、总结

获取 Giscus key 的关键点只有一句话：

👉 在 giscus.app 页面选择仓库和分类后，从页面底部自动生成的 script 中复制即可

Giscus Key 如何获取（repo-id 与 category-id 获取完整指南）