访问统计
文章目录
专栏目录 · 主题文档
本页汇总访问统计服务的接入方法。目前支持百度统计;Google Analytics 等其他服务尚未接入,后续支持后会在本页补充。
百度统计
配置跟踪 ID
此功能在 v0.5.0 之后加入。将下面配置放入博客根目录的 _config.syutoi.yml(本仓库示例站使用 example/_config.syutoi.yml):
analytics: |
在百度统计后台添加站点并获取安装代码,只复制 hm.js? 后的 32 位十六进制跟踪 ID,替换上面的占位文字。不要填写整段 JavaScript、完整 URL 或后台地址中的数字站点编号;ID 必须用引号包裹,避免纯数字被 YAML 当作数值。
生成与部署
保存后重启预览;正式部署前执行 pnpm exec hexo clean 和 pnpm exec hexo generate。主题仓库可执行 pnpm clean && pnpm build。所有使用主题布局的页面都会初始化 _hmt 队列,并通过 HTTPS 异步加载百度统计脚本,无需另装 Hexo 插件或手动粘贴代码。独立的原始 HTML 文件不经过主题布局,不会自动添加统计。
关闭与本地预览
默认 baidu: '' 完全关闭;空值、非字符串和格式无效的 ID 同样不输出统计脚本。启用后本地预览也会加载统计,预览时如不希望记录访问,可临时留空。不要同时通过其他插件注入同一统计代码,以免重复计数。
验证效果
验证时查看生成页面源码是否包含 https://hm.baidu.com/hm.js?你的ID,并在浏览器 Network 中确认脚本请求。广告拦截或网络限制可能阻止上报;脚本生成成功不等于后台已经收到访问数据。本功能会连接百度统计服务,主题没有增加访问计数显示或自定义事件上报。
接入方式参考 百度统计代码介绍。旧的 baidu_analytics 字段不自动启用统计,请改用上述配置。
常见问题
| 现象 | 检查方式 |
|---|---|
| 页面没有统计脚本 | 检查主题版本、配置文件位置和 ID 是否为带引号的 32 位十六进制字符串;修改后重启并重新生成 |
| 本地有脚本,线上没有 | 确认最新生成目录已部署,刷新缓存;只修改本地配置不会更新线上站点 |
| 脚本加载成功但报表没有数据 | 核对百度后台的站点与 ID、浏览器 Network 中的上报请求;脚本加载不代表收数已完成 |
| 数据重复 | 检查是否同时在模板、Hexo 插件或自定义 HTML 中粘贴了统计代码 |
复制主题示例时,请将示例站的 ID 换成自己站点的 ID。hexo.syutoi.com 的配置只属于该示例站,不是公共统计服务。统计不会在侧栏显示访客数,也不替代文章、分类、标签数量。