首屏卡顿根因需分层定位：用WAPA抓长任务调用链（如document.write阻塞），结合DevTools Network看DOMContentLoaded与FCP间隔、资源启动时机及Blocking Queue，真机调试必用chrome://inspect或Safari Web Inspector。
前端HTML性能问题调试，关键不是打开一堆面板，而是先确认瓶颈在哪一层：是首屏白屏太久、滚动卡顿、还是交互响应迟滞？WAPA 和 Chrome DevTools 是唯二真正能归因到具体资源或脚本的工具，其他“一键分析”类工具基本只能看表面数字。
怎么用 WAPA 定位首屏卡顿根因
WAPA 不是替代 DevTools，而是补足它看不到的归因链。比如你看到首屏 FCP 延迟 1.2s，DevTools 的 Network 面板只告诉你 main.js 下载用了 800ms，但无法说明这 800ms 里有多少花在解析、多少在执行、有没有长任务阻塞渲染。
- 必须在页面
最顶部插入 WAPA 初始化脚本，确保采集从 HTML 解析第一帧就开始 - 重点看
wapa.report().longTasks返回的数组，每个对象含startTime、duration、stack，其中stack能定位到具体函数调用链 - 若发现
duration > 50ms的长任务集中在document.write或内联<script></script>执行阶段，说明 HTML 里存在阻塞式脚本，需改用defer或移出 - 注意 WAPA 默认不采集第三方 SDK 的子任务，如需分析微信 JS-SDK 加载耗时，得手动在
jsapi.ready回调里打点wapa.mark('wxjsdk_ready')
Chrome DevTools 里哪些 Waterfall 线索不能忽略
Network 面板的瀑布图不是用来数请求数量的，而是找「不该出现在这个时间点」的资源。移动端真机上尤其明显。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
-
DOMContentLoaded和FCP间隔超过 300ms：大概率有未async的<script></script>或内联<style></style>阻塞了解析 -
main.js的Start Time比index.html的End Time晚 >200ms：说明 DNS 查询或 TCP 握手慢，需检查是否用了非同源 CDN 或未开启preconnect - 某个
font.woff2的Blocking Queue时间长：不是字体本身问题，而是它前面的stylesheet未加载完，导致字体加载被挂起 - 所有图片资源都标着
(inactive)：说明它们被loading="lazy"拦住了，但首屏图片也这样，就是写错了——iOS 15.4 以下直接不加载，得加loading="eager"
为什么真机调试时 DevTools Device Mode 不可信
Device Mode 只模拟 viewport 和媒体查询，不模拟真实渲染引擎行为。你在桌面 Chrome 里看到的 60fps，放到中低端安卓机上可能只剩 22fps，且根本看不出原因。
立即学习“前端免费学习笔记（深入）”；
- 安卓 WebView 必须通过
chrome://inspect连接真机，选中目标页面后点“inspect”，才能看到真实的Performance录制结果 - iOS 真机要开启 Safari Web Inspector（设置 → Safari → 高级 → Web Inspector），再在 Mac 的 Safari 开发菜单里选中设备，否则连不到 WebKit 内核
- 真机录制时禁用 “Screenshots” 选项，否则每帧截图会拖慢采样，掩盖真实掉帧点
- 如果发现
Layout阶段耗时突增，大概率是某处用了offsetWidth或getComputedStyle触发了强制同步布局，得搜代码里这些函数调用
最常被忽略的其实是 HTML 本身的结构问题：比如把 <script src="vendor.js"></script> 放在 底部，看似不阻塞，但如果它内部又动态 document.write 了一个 <link rel="stylesheet">，那这个 CSS 就会重新触发一次阻塞解析——这种嵌套阻塞，WAPA 能抓到，DevTools 的 Network 却只显示一个干净的请求。
