必须将百度统计js注入template.h5.html的中并确保早于#app渲染，因spa路由切换不触发script重载，否则导致pv不上报、_hmt未定义；history模式需手动监听路由调用_hmt.push(['_trackpageview'])。
uni-app h5端接入百度统计，核心就一条：不能靠 uni.report 或条件编译里直接写 _hmt.push，必须把百度统计 js 注入到 html 模板的 中，且要确保它在 <div id="app"> 渲染前就加载并初始化。
<h3>为什么不能在 Vue 文件里用条件编译加载百度统计 JS</h3>
<p>因为 H5 是单页应用（SPA），<code>router 切换页面时不会重新执行 <script></script> 标签，只靠 #ifdef H5 在某个页面的 <script></script> 里动态插入百度统计脚本，会导致：后续路由跳转后 PV 不上报、事件丢失、_hmt 未定义报错。
- 浏览器控制台常见错误：
Uncaught ReferenceError: _hmt is not defined - 百度统计后台只看到首页 PV，子页面（如
/pages/user/profile）无数据 - 即使手动调用
_hmt.push(['_trackPageview'])，也因脚本未全局挂载而失败
必须用自定义 template.h5.html 模板注入
uni-app 的 H5 构建依赖 html-webpack-plugin，所有页面共用一个 HTML 模板。只有在这里注入百度统计代码，才能保证它随整个 SPA 一起加载、全局可用。
- 在项目根目录新建文件：
template.h5.html - 内容必须包含标准的百度统计异步加载代码，且放在
内（不是底部） - 在
manifest.json→h5节点下配置："template": "template.h5.html" - 确保
hm.js?your_id中的your_id替换为你在 百度统计后台 创建站点后获取的真实 ID（格式如9f3a1b2c3d4e5f6g7h8i9j0k1l2m3n4o）
<script>
var _hmt = _hmt || [];
(function() {
var hm = document.createElement("script");
hm.src = "https://hm.baidu.com/hm.js?your_id";
var s = document.getElementsByTagName("script")[0];
s.parentNode.insertBefore(hm, s);
})();
</script>
H5 路由切换时如何补全子页面 PV 上报
默认情况下，百度统计 JS 只在首次加载时触发一次 pageview。uni-app H5 使用 hash 或 history 模式路由，后续跳转不会刷新页面，所以必须手动监听路由变化并上报。
- 仅对 hash 模式（
h5.router.mode: 'hash'）：可启用百度官方插件UrlChangeTracker - 在
template.h5.html的百度统计脚本后追加：
<script>
_hmt.push(['_requirePlugin', 'UrlChangeTracker', {
shouldTrackUrlChange: function(newPath, oldPath) {
return newPath && oldPath && newPath !== oldPath;
}
}]);
</script>
- 如果是 history 模式（
h5.router.mode: 'history'），需在main.js中监听uni.$on('routeChange')或使用router.afterEach（需搭配@dcloudio/uni-h5-router或自行 patch）手动调用_hmt.push(['_trackPageview'])
别漏掉域名白名单和上线验证
本地开发时百度统计不生效是正常现象——它只在正式域名（非 localhost、127.0.0.1）下收集数据，且有 10–30 分钟延迟。
- 确保你的 H5 站点已备案，并将域名添加到百度统计后台「管理」→「网站设置」→「站点域名」中
- 上线后，在百度统计「实时访客」里看是否有「新访客进入」记录；再等 20 分钟，检查「访问分析」→「页面分析」里是否出现多级路径（如
/、/pages/goods/list） - 如果始终没数据，打开浏览器开发者工具 → Network 标签页，过滤
hm.gif，确认是否有请求发出且返回 200
最容易被忽略的是：百度统计 JS 必须在 里，且不能被任何条件编译包裹；UrlChangeTracker 插件必须在 _hmt 初始化之后、第一次 _trackPageview 之前调用；history 模式下没有自动监听页面切换，得自己写监听逻辑。
