前言

不蒜子（busuanzi）是很多 Hexo 博客使用的访问统计工具，简单免费且无需注册。但由于官方接口 busuanzi.ibruce.info 有时访问不稳定，甚至出现了完全不能使用的情况，本文教你如何将其替换为新接口 cn.vercount.one，提升统计加载速度和稳定性。

一、什么是不蒜子？

功能介绍

不蒜子是一个极简的网站计数器，可以统计：

  • 站点 UV（Unique Visitor） - 网站总访客数
  • 站点 PV（Page View） - 网站总浏览量
  • 文章 PV - 单篇文章阅读量

工作原理

1
2
3
4
5
6
7
8
9
访客打开网页
    ↓
加载不蒜子 JS 脚本
    ↓
脚本扫描页面中的特定 ID
    ↓
向统计服务器发送请求
    ↓
返回数据并显示在页面上

存在的问题

  1. 官方接口不稳定 - busuanzi.ibruce.info 偶尔无法访问，甚至出现了完全不能使用的情况
  2. 加载速度慢 - 访问速度可能较慢
  3. 影响用户体验 - 加载失败会导致统计数据无法显示

二、为什么要更换接口？

新接口的优势

对比项 官方接口 新接口
访问速度 ⭐⭐ ⭐⭐⭐⭐⭐
数据兼容 ✅ ✅ 完全兼容
可用性 较低 较高

新接口地址

  • 推荐使用： cn.vercount.one
  • 接口地址： //cn.vercount.one/js
  • 特点： 数据完全兼容，无需重新累计

三、修改步骤（保姆级）

需要修改的文件

1
2
3
4
5
6
7
8
你的博客根目录/
└── themes/
    └── butterfly/
        └── layout/
            └── includes/
                ├── additional-js.pug       ← 修改文件 1
                └── head/
                    └── preconnect.pug      ← 修改文件 2

步骤 1：修改 JS 引入

文件位置： themes/butterfly/layout/includes/additional-js.pug

找到第 56-57 行左右：

1
2
if theme.busuanzi.site_uv || theme.busuanzi.site_pv || theme.busuanzi.page_pv
  script(async data-pjax src= theme.asset.busuanzi || '//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js')

修改为：

1
2
if theme.busuanzi.site_uv || theme.busuanzi.site_pv || theme.busuanzi.page_pv
  script(async data-pjax src= theme.asset.busuanzi || '//cn.vercount.one/js')

修改说明：

  • 将 //busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js
  • 替换为 //cn.vercount.one/js

步骤 2：修改预连接

文件位置： themes/butterfly/layout/includes/head/preconnect.pug

找到最后几行（第 34-35 行左右）：

1
2
if !theme.asset.busuanzi && (theme.busuanzi.site_uv || theme.busuanzi.site_pv || theme.busuanzi.page_pv)
  link(rel="preconnect" href="//busuanzi.ibruce.info")

修改为：

1
2
if !theme.asset.busuanzi && (theme.busuanzi.site_uv || theme.busuanzi.site_pv || theme.busuanzi.page_pv)
  link(rel="preconnect" href="//cn.vercount.one")

修改说明：

  • 将 //busuanzi.ibruce.info
  • 替换为 //cn.vercount.one

preconnect 的作用：

  • 提前建立与统计服务器的连接
  • 减少后续请求的延迟
  • 提升页面加载速度

步骤 3：重新生成网站

在博客根目录执行以下命令：

1
2
3
4
5
6
7
8
# 清除缓存
hexo clean

# 重新生成
hexo g

# 本地预览
hexo s

访问 http://localhost:4000 查看效果。

四、常见问题

Q1：修改后数据会清零吗？

A： 不会！新接口与官方数据完全兼容，之前累计的访问量不会丢失。

Q2：统计数据不显示怎么办？

检查清单：

  1. 确认配置已启用

    1
    2
    3
    4
    busuanzi:
      site_uv: true
      site_pv: true
      page_pv: true

  2. 清除浏览器缓存

    • 按 Ctrl + F5 强制刷新

  3. 检查主题文件修改

    • 确认两个文件都已修改
    • 检查是否有拼写错误

  4. 查看控制台错误

    • 按 F12 打开开发者工具
    • 查看 Console 是否有报错

Q3：可以同时使用多个统计工具吗？

A： 可以！你可以同时使用：

  • 不蒜子 - 显示在侧边栏（快速查看）
  • Google Analytics - 详细数据分析
  • 百度统计 - 国内 SEO 优化

它们不会冲突。

五、总结

修改要点

  1. 修改 JS 引入地址 - additional-js.pug
  2. 修改预连接地址 - preconnect.pug
  3. 清除缓存并重新生成 - hexo clean && hexo g

核心改动

1
2
3
官方接口：//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js
         ↓
新接口：//cn.vercount.one/js

注意事项

  • 不需要修改配置文件
  • 数据不会丢失
  • 完全兼容原有功能
  • 提升加载速度和稳定性

结语

通过本教程，你已经成功将 Butterfly 主题的不蒜子统计接口替换为新接口，大大提升了访问统计的加载速度和稳定性。如果你觉得本教程对你有帮助，欢迎分享给更多需要的朋友！