如何构建评论系统

一、部署 Twikoo 云函数（推荐使用 Vercel）

1. 打开 Twikoo 官方 GitHub：

点击项目地址
点击右上角 [Use this template] → 选择 Create a new repository

2. 创建后进入你的新仓库 → 点右上角 Deploy to Vercel

使用 GitHub 账号登录 Vercel
授权仓库
自动部署完成后，得到你的评论服务 URL，例如：
https://twikoo-yourname.vercel.app

二、配置 Fluid 主题支持 Twikoo

1. 修改 Hexo 博客配置 _config.yml：

comment:
  type: twikoo
  twikoo:
    envId: https://twikoo-yourname.vercel.app
    region: 'ap-shanghai'
    path: window.location.pathname

==注意==：

envId 是你刚才部署成功后得到的 Vercel URL

另外你需要将项目添加自定义域名，负责国内可能无法加载！

path 使用 window.location.pathname 即可自动匹配当前文章页面

三、添加评论容器 HTML（Fluid 已集成）

Fluid 主题默认会在文章页加载评论区，无需额外操作。如果没有看到评论区，请检查以下两点：

每篇文章的 Front Matter 没有设置 comments: false

页面底部是否有评论（Fluid 会自动插入）

四、部署 Hexo 并测试

1
2
3

hexo clean
hexo g
hexo d

打开任意文章页面，应该能看到 Twikoo 评论框。第一次评论会自动创建数据库结构。

五、Vercel 中开启数据持久化（选做）

Twikoo 默认会自动使用 Vercel 的 Serverless 存储，但你也可以切换到 MongoDB：

使用 MongoDB Atlas 创建数据库

将连接 URI 设置到 Vercel 的环境变量中（MONGO_URI）

具体迁移请参照twikoo官方文档

重新部署即可

六、可选功能配置

你可以登录 Twikoo 控制台评论后使用管理员身份，支持如下功能：

评论管理（删除/审核）

邮件通知

自定义表情

阅读量（需额外 Worker）请参考我的另一片文章[[如何创建阅读统计]]

七、Twikoo 的核心优点（对比 Valine / Waline 等）

部署简单，无需后端服务器

支持 Vercel 一键部署，不需要你手动建数据库、搭后端。

支持 Serverless 结构（Vercel / Cloudflare Workers / 云函数），易迁移、易维护。

无需备案，隐私安全

完全本地/私有部署，无需依赖中国大陆的服务。

不记录 IP，不做任何埋点，隐私更纯净。

功能全面且可选

Emoji 表情	✅
邮件通知	✅
评论点赞	✅
阅读量统计	✅
评论审核/管理	✅
匿名评论	✅
垃圾评论过滤	✅
Markdown 评论	✅
QQ 昵称头像自动拉取	✅

适配广泛

Hexo / VuePress / Hugo / WordPress 等所有主流框架都能接入。

主流主题（Fluid、NexT、Butterfly、Volantis）都原生支持。

界面美观、响应式强

UI 简洁现代，移动端体验优异。

可自定义皮肤、样式，自适应深色模式。

维护活跃，文档清晰

官方仓库维护积极，文档完善：https://twikoo.js.org

社区活跃，有问必答。

个人认为Twikoo 是目前 Hexo 静态博客最理想的评论系统解决方案。比 Waline 轻量、比 Valine 安全、比 Gitalk 省心，是追求体验与自由的最佳选择。

#技术笔记

如何构建评论系统

https://kowo.121126.xyz/2025/05/10/如何构建评论系统/

作者

半条狗

发布于

2025年5月10日

更新于

2025年9月25日

许可协议

如何创建阅读统计下一篇