4. 评论系统配置指南
696 字
3 分钟
4. 评论系统配置指南
评论系统配置指南
配置文件位置
src/config/commentConfig.ts
支持的评论系统
| 评论系统 | 说明 | 难度 |
|---|---|---|
| Giscus | 基于 GitHub Discussions | 简单 |
| Twikoo | 腾讯云开发版 | 简单 |
| Waline | Vercel 部署版 | 中等 |
| Artalk | 自建后端版 | 较难 |
| Disqus | 国外老牌评论系统 | 简单 |
| none | 不启用评论系统 | - |
Giscus 配置（推荐）
Giscus 是一个基于 GitHub Discussions 的评论系统，免费、稳定、易用。
1. 安装 GitHub App
访问 https://github.com/apps/giscus ，点击 “Install” 安装到你的 GitHub 仓库。
2. 配置仓库
安装后，在仓库的 Settings → Pages 中：
- Source 选择 GitHub Actions
3. 获取配置参数
访问 https://giscus.app/zh-CN ，填写你的仓库信息，获取以下参数：
giscus: { // 设置 Giscus 评论系统仓库（格式：用户名/仓库名） repo: "你的用户名/你的仓库名", // 仓库 ID（从 giscus.app 获取） repoId: "R_xxxxxxxxxxxx", // 评论分类名称 category: "General", // 分类 ID（从 giscus.app 获取） categoryId: "DIC_xxxxxxxxxxxx", // 映射方式：pathname, URL, title 等 mapping: "pathname", // 是否启用 reactions reactionsEnabled: "1", // 评论输入位置：bottom, top inputPosition: "bottom", // 语言：zh-CN, en 等 lang: "zh-CN",},4. 更多配置项
giscus: { // 严格模式 strict: "0", // 是否发送元数据 emitMetadata: "0", // 加载方式：lazy, eager loading: "lazy",},Twikoo 配置
Twikoo 是一个基于腾讯云开发的评论系统，部署简单。
1. 获取环境 ID
- 进入 https://console.cloud.tencent.com/tcb
- 创建一个云开发环境
- 在云开发控制台中，开通「云函数」服务
- 创建一个环境后，在环境设置中获取环境 ID
2. 配置示例
twikoo: { // 环境 ID envId: "your-env-id-xxxxx", // 语言 lang: "zh-CN", // 是否启用访问量统计 visitorCount: true,},Waline 配置
Waline 是一个基于 Vercel 部署的评论系统。
1. 部署 Waline 服务
- Fork https://github.com/walinejs/waline 到你的 GitHub
- 在 Vercel 中导入该项目
- 配置环境变量：
LEAN_ID: LeanCloud 应用 IDLEAN_KEY: LeanCloud 应用 KeyLEAN_MASTER_KEY: LeanCloud Master Key
- 部署后获取服务 URL
2. 配置示例
waline: { // Waline 服务地址 serverURL: "https://your-waline.vercel.app", // 语言 lang: "zh-CN", // 登录模式 login: "enable", // 表情包配置 emoji: [ "https://unpkg.com/@waline/emojis@1.4.0/weibo", "https://unpkg.com/@waline/emojis@1.4.0/bilibili", ], // 访问量统计 visitorCount: true,},切换评论系统
在 commentConfig.ts 中修改 type 字段：
export const commentConfig: CommentConfig = { // 切换评论系统 type: "giscus", // 可选: giscus, twikoo, waline, artalk, disqus, none // ...},禁用评论功能
方法一：设置 type 为 none
type: "none",方法二：在文章 frontmatter 中单独禁用
---title: 我的文章comment: false // 这篇文章禁用评论---常见问题
Q: 评论不显示？
- 检查浏览器控制台是否有错误
- 确认配置参数是否正确
- 确认评论系统服务是否正常运行
Q: 如何开启访问量统计？
在对应评论系统的配置中设置 visitorCount: true
Q: 如何修改评论框语言？
在配置中找到 lang 字段，设置为 zh-CN（中文）或 en（英文）
支持与分享
如果这篇文章对你有帮助，欢迎分享给更多人或赞助支持！
相关文章 智能推荐
1
12. 字体配置指南
博客搭建 博客字体配置教程，包含内置字体选择、自定义字体添加、字体加载优化等详细设置。
2
9. 看板娘配置指南
博客搭建 博客看板娘配置教程，支持 Spine 和 Live2D 两种模型，包含位置、大小、交互等详细配置。
3
16. 国际化配置指南
博客搭建 博客国际化配置教程，包含多语言支持、翻译管理、语言切换、SEO优化等详细设置。
4
13. 搜索功能配置指南
博客搭建 博客搜索功能配置教程，包含内置PageFind搜索、搜索框设置、搜索结果优化等详细设置。
5
11. 主题颜色配置指南
博客搭建 博客主题颜色配置教程，包含主色调、深色模式、固定模式等详细设置。
随机文章 随机推荐
评论区
Hi，欢迎来到 Coldairboy学习笔记。
音乐
暂未播放
0:00 0:00
31
3
5
36,702
0 天
0 天前