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

如果你正在为博客接入 Giscus 评论系统，大概率会遇到两个关键参数：

• data-repo-id

• data-category-id

很多人在这里卡住，不清楚这些值从哪里获取，也不知道为什么有时候页面无法生成对应配置。

本文会完整介绍 Giscus Key 的获取方式，并说明整个配置流程中需要注意的事项，帮助你顺利完成评论系统接入。

一、什么是 Giscus Key？

Giscus 是一个基于 GitHub Discussions 的评论系统。它的核心思路是：把博客评论映射到 GitHub 仓库中的 Discussions 讨论里。

在接入 Giscus 时，最常见的两个配置项就是：

• data-repo-id

• data-category-id

这两个值通常被称为 Giscus Key。

它们分别表示：

• repo-id：你的 GitHub 仓库内部唯一标识

• category-id：你所选择的 Discussions 分类内部唯一标识

也就是说，Giscus 需要通过这两个参数来确认评论应该属于哪个仓库、哪个讨论分类。

二、开始之前需要准备什么？

在正式获取 Giscus Key 之前，需要先确保以下条件已经满足：

1. 拥有一个 GitHub 公共仓库

Giscus 依赖 GitHub Discussions，而 GitHub Discussions 需要绑定在仓库上使用。通常建议使用公开仓库来承载评论。

2. 安装 Giscus App

你需要先在 GitHub 上安装 Giscus 官方应用，并授权它访问对应仓库。

安装地址：

https://github.com/apps/giscus

安装时记得选择你要接入评论的目标仓库。

3. 仓库已开启 Discussions

进入仓库设置页后，确认已经启用 Discussions 功能。

路径通常是：

Settings → Features → Discussions

如果没有开启，Giscus 无法读取讨论分类，也就无法正常生成 category-id。

4. 至少存在一个 Discussion 分类

进入仓库的 Discussions 页面后，确认已经创建至少一个分类，例如：

• 
  General
  

• 
  Announcements
  

• 
  Blog Comments
  

如果没有分类，后续即使识别到仓库，也无法生成完整配置。

三、Giscus Key 的完整获取步骤

第一步：打开 Giscus 官方配置页面

访问官方配置工具：

https://giscus.app/zh-CN

这是 Giscus 提供的可视化配置页面，所有关键参数都会在这里自动生成。

第二步：输入仓库信息

在仓库输入框中填写你的 GitHub 仓库地址，格式如下：

username/repo

例如：

hezongcheng/blog

这一项非常关键。只有仓库被正确识别后，页面才会继续加载后续配置。

第三步：等待系统自动解析仓库

仓库输入正确后，Giscus 页面会自动执行几件事：

• 
  拉取仓库信息
  

• 
  读取 Discussions 设置
  

• 
  获取仓库内部 ID
  

• 
  展示可选分类
  

如果一切正常，你会看到类似下面的配置值：

data-repo-id="R_kgDOxxxx"

这就是对应仓库的 repo-id。

第四步：选择 Discussions 分类

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

• 
  General
  

• 
  Announcements
  

• 
  Blog Comments
  

当你选中某个分类后，页面会自动生成该分类对应的 ID，例如：

data-category-id="DIC_kwDOxxxx"

这就是 category-id。

第五步：从自动生成的 script 中提取 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 需要手动查找、通过接口获取，或者去 GitHub 后台单独复制。

实际上并不是。

Giscus Key 的正确获取方式只有一种：

在 Giscus 官方配置页面中选择仓库与分类，然后从自动生成的 script 代码里提取。

也就是说：

• repo-id 不是手动创建的
  

• category-id 不是手动填写的
  

• 
  它们都由系统自动生成
  

五、为什么没有生成 Key？常见问题排查

如果你已经输入了仓库，但仍然看不到 repo-id 或 category-id，通常可以从下面几个方向检查。

1. 没有登录 GitHub

Giscus 页面需要读取你的仓库权限信息。如果没有登录 GitHub，部分数据可能无法正常加载。

解决方法很简单：先登录 GitHub，再重新打开配置页面。

2. 没有安装 Giscus App

如果仓库没有授权给 Giscus，配置页通常无法正确读取仓库状态。

这时需要重新检查 Giscus App 是否已经安装，以及是否选择了目标仓库。

3. 仓库没有开启 Discussions

Giscus 依赖 GitHub Discussions 作为评论存储载体。如果仓库没有启用 Discussions，分类就无法被读取。

进入仓库设置，开启 Discussions 后再返回配置页刷新。

4. 没有创建分类

就算开启了 Discussions，如果没有任何分类，也依然无法生成 category-id。

建议至少创建一个专门用于评论的分类，例如：

Blog Comments

这样既清晰，也方便后续管理。

5. 仓库不是 Public

如果你的仓库不可公开访问，Giscus 可能无法正常工作。通常建议直接使用公共仓库作为评论承载仓库。

6. 权限不足

如果你不是仓库所有者，或者没有足够权限，也可能导致配置项无法生成。

你至少需要具备以下身份之一：

• 
  仓库 Owner
  

• 
  仓库 Collaborator
  

六、关于 repo-id 和 category-id 的本质

从本质上看，这两个值只是 GitHub 内部资源的唯一标识。

你可以这样理解：

• repo-id 对应某一个具体仓库
  

• category-id 对应这个仓库下某一个具体的 Discussions 分类
  

Giscus 在运行时会依靠这两个 ID，把评论正确写入对应位置。

所以它们并不是“额外的密钥”，而是系统识别资源所需要的内部参数。

七、实际使用时的建议

1. 建议单独创建评论分类

不要直接把博客评论放进默认分类里，最好新建一个专门分类，比如：

• 
  Blog Comments
  

• 
  Site Comments
  

这样后续维护更清晰，也不会和普通 Discussions 混在一起。

2. 尽量保持文章路径稳定

如果你在接入时使用路径映射，例如 pathname，那么文章链接变化可能会影响评论匹配。

因此建议在博客上线后尽量不要频繁修改文章 URL。

3. 先在测试环境验证一遍

接入完成后，建议先在本地或测试环境检查以下内容：

• 
  评论框是否正常显示
  

• 
  是否可以登录 GitHub
  

• 
  是否能成功创建评论
  

• 
  评论是否写入对应 Discussions 分类
  

确认无误后再部署到正式环境。

八、总结

获取 Giscus Key 的流程并不复杂，关键只有一句话：

在 Giscus 官方配置页面中输入仓库、选择分类，然后从自动生成的 script 中复制 data-repo-id 和 data-category-id。

只要你提前完成以下准备：

• 
  安装 Giscus App
  

• 
  开启 Discussions
  

• 
  创建分类
  

• 
  使用公开仓库
  

通常就能顺利拿到所需的 Key。

如果你的页面没有生成对应参数，优先检查登录状态、仓库权限、Discussions 开启情况以及分类是否存在，基本都能定位到问题。