第三方分析脚本必须紧贴</body>闭合标签上方，不能放<head>里或</body>之后；放太早导致DOM未就绪、gtag未定义，放太晚则脚本被忽略；推荐加async（独立统计类）或defer（需DOM操作类），且仅对外部脚本生效。
第三方分析脚本该插在 index.html 的哪个位置
必须紧贴 </body> 闭合标签上方，不能放 <head> 里，也不能放在 </body> 之后。
常见错误是塞进 <head> 顶部，结果页面一加载就报 ReferenceError: gtag is not defined 或 analytics is not defined；也有开发者扔进某个组件模板（比如 Footer.vue），但该组件没被所有路由渲染，导致漏统计。
- 放太早：DOM 还没构建，
document.body是null，SDK 初始化失败或静默跳过 - 放太晚：浏览器已结束解析，
<script>标签被忽略，脚本根本不执行 - 唯一安全位置：
</body>前一行，确保 DOM 已就绪、全局变量可访问、且不影响首屏渲染阻塞
要不要加 async 或 defer？怎么选
绝大多数埋点类脚本（如 Google Analytics、Umami、Plausible）适合加 async；但像某些需操作 DOM 或依赖其他初始化逻辑的 SDK（如部分客服 widget、SensorsData 的完整版），得用 defer。
async 和 defer 都只对带 src 的外部脚本生效，对内联脚本无效——这点常被忽略。
立即学习“前端免费学习笔记（深入）”；
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
-
async：下载不阻塞，但一完成就立刻执行，不等 DOM，也不保序。适合完全独立、无需 DOM、越早上报越好的脚本 -
defer：下载不阻塞，执行严格等到 HTML 解析完毕、DOM 构建完成之后，且多个defer脚本按顺序执行 - 别混用：同时设
async和defer时，async优先级更高，defer失效
为什么本地 file:// 协议下统计脚本总不工作
不是代码错了，而是协议限制：多数分析脚本明确拒绝 file:// 协议，会直接退出或静默失败，连错误都不抛。
广告拦截插件（如 uBlock Origin）也会拦截 analytics.example.com 这类域名，表现为 net::ERR_BLOCKED_BY_CLIENT，这不是你服务器或代码的问题。
- 调试务必用
http://localhost或真实 HTTP 服务（Vite、Webpack Dev Server、Python -m http.server 都行） - 上线前检查 CSP（Content Security Policy）头是否放行了脚本域名，例如
script-src 'self' https://www.google-analytics.com - 需要手动初始化的 SDK（如 SensorsData、Umami），光引入
script不够，还得显式调用sensors.init()或赋值window.umami = {...}
怎么验证统计代码真正在上报
别只看控制台有没有报错，重点查网络请求和后台实时数据。
打开 Chrome DevTools → Network 标签页 → 刷新页面 → 筛选 analytics、hm.js、gtm.js 或对应域名，确认有 200 请求发出；再登录统计平台后台，看“实时访客”或“今日 PV”是否秒级更新。
- 如果 Network 里没请求：检查路径是否拼错（比如少个
https://）、CSP 是否拦截、脚本是否被广告插件屏蔽 - 如果有请求但后台没数据：确认配置 ID 是否正确（如百度统计的
?xxxxxxxxxxxxxx）、是否误用了测试环境 ID - 部分 SDK（如 Sentry）默认只在 production 环境上报，开发环境需显式设
environment: 'development'
最易被忽略的是：脚本加载成功 ≠ 数据上报成功。初始化失败、配置缺失、权限拒绝（如用户禁用 JS 或 tracker）都会让请求发不出去，但浏览器不会报明显错误。
