TapCub 正式上线:统计、分析、客服一个平台免费用
帮助中心

React、Vue 或 Next.js 应用怎么统计?

单页应用里代码放哪、路由切换怎样变成页面浏览,以及什么时候要加 hash 属性。

快速开始1 分钟阅读最后更新 2026 年 10 月 28 日TapCub 团队所属指南: 在网站上安装 TapCub

简短回答

在根 HTML 模板或根布局里加一次代码。用 History API 的路由切换会自动记录;hash 路由要加 data-hash="true"。

代码放哪

在 网站统计配置SDK 代码 复制代码,里面已经带了你的站点 Key,长这样:

SDK 代码
<script defer src="https://static.pathclue.com/client.js" data-site="YOUR_SITE_KEY"></script>

只加一次,放在为所有路由输出文档 head 的文件里:Vite 或 Create React App 项目的 index.html,Next.js、Nuxt 的根布局。不要放在每个页面都会挂载的组件里。

路由切换怎样计数

脚本监听 history.pushState、history.replaceState 以及浏览器的前进后退,React Router、Vue Router、Next.js、Nuxt 都是这样切页面的。每个新 URL 记一次页面浏览,切换时补上上一个路由的停留时长。URL 没变的切换不会重复计数。

路由方式要做什么
History 模式(/pricing)什么都不用做,大多数框架默认就是它。
Hash 模式(/#/pricing)给标签加 data-hash="true",# 后面的部分才算作页面。
没有前端路由的服务端渲染页面什么都不用做,每次跳转都是完整的页面加载。

路由切换后自己再调 tapcub.pageview() 也没问题,只是没必要:同一个 URL 不会发两次。

本地开发

在 localhost 上脚本默认什么都不发,开发流量不会混进报表。要在本地测试,见在 localhost 上测试。

相关阅读

这篇回答解决你的问题了吗?

我们会根据反馈修改和补充这篇内容。

看清数据,找到增长。

每一次点击,都有数据依据。装好一行代码,1 分钟看到第一批数据。

无需信用卡 · 统计与客服都有免费版 · 统计无 Cookie