评论功能添加

刀刀

0字

0分钟

8/13/2026

vitepressgiscuscomment

讲解 VitePress 博客中集成 Giscus 评论系统的完整步骤，包括 GitHub 仓库配置与主题集成。

前置配置

新增仓库

新建一个仓库，专门用于存放用户评论的数据。要求该仓库是公开的。创建完毕后前往 setting 模块，下拉勾选 Discussions 选项，点击 install 按钮，开启 Discussions 功能。

GitHub 账号下载插件

点击右上角的个人头像，选择Setting 设置，左侧导航栏下拉找到 Applications 。点击 New OAuth App 新建一个应用。搜索 giscus，选择刚刚新建好的新公开仓库。

官网配置

前往 giscus 官网，复制刚刚新建好的公开仓库地址到输入框内，选择 "Discussion 的标题包含页面的 pathname" 显示评论者的昵称。

讨论分类推荐选择 announcements ：

讨论分类

下面的特性根据自己的需要来自行配置。一切都配置好后往下拉，可以看到已经生成好对应的脚本，复制保存下面要用。

功能实现

安装插件

pnpmnpm

bash

 pnpm add vitepress-plugin-comment-with-giscus

bash

 npm i vitepress-plugin-comment-with-giscus

配置插件

前往 .vitepress/themme/index.js 文件中配置 giscus 插件。把前面获取到的脚本代码里的参数一一对应复制上去即可。

import DefaultTheme from 'vitepress/theme'
import giscusTalk from 'vitepress-plugin-comment-with-giscus'
import { useData, useRoute } from 'vitepress'

export default {
  ...DefaultTheme,
  enhanceApp() {
    // ...
  },
  setup() {
    // Get frontmatter and route
    const { frontmatter } = useData()
    const route = useRoute()

    // Obtain configuration from: https://giscus.app/
    giscusTalk(
      {
        repo: 'your github repository',
        repoId: 'your repository id',
        category: 'your category', // default: `General`
        categoryId: 'your category id',
        mapping: 'pathname', // default: `pathname`
        inputPosition: 'top', // default: `top`
        lang: 'en', // default: `zh-CN`
        lightTheme: 'light', // default: `light`
        darkTheme: 'transparent_dark', // default: `transparent_dark`
        // ...
      },
      {
        frontmatter,
        route,
      },
      // Whether to activate the comment area on all pages.
      // The default is true, which means enabled, this parameter can be ignored;
      // If it is false, it means it is not enabled.
      // You can use `comment: true` preface to enable it separately on the page.
      true
    )
  },
}

贡献者

duyidao

v_duyilin

刀刀

页面历史

最后编辑于 2 个月前

查看完整历史

评论功能添加 ​

前置配置 ​

新增仓库 ​

GitHub 账号下载插件 ​

官网配置 ​

功能实现 ​

安装插件 ​

配置插件 ​

贡献者