loading="lazy"对首屏iframe完全无效，因其被浏览器规范强制立即加载并阻塞HTML解析；必须改用data-src+IntersectionObserver主动控制生命周期。

iframe 加载慢，根本不是“它本身慢”，而是你让它在错误的时间、用错误的方式抢资源。核心解法就一条：不让它在 DOM 解析阶段就发起请求。

---

loading="lazy" 为什么加了也没用

• 写了 loading="lazy" 但首屏 iframe 还是卡住？这是浏览器规范强制行为：只要元素初始位置在视口内（getBoundingClientRect().top <= window.innerHeight），就会立刻加载并阻塞 HTML 解析。
• Safari 15.3 及更早、IE、多数安卓 WebView 完全忽略该属性，回退为 eager。
• 父容器用了 overflow: hidden、transform 或 position: fixed，会导致浏览器无法准确判断布局位置，懒加载逻辑直接跳过。
• src 带随机参数（如 ?t=1712345678）或服务端重定向，缓存失效，loading 形同虚设。

---

首屏必须显示的 iframe 怎么真正延迟加载

不能靠属性，必须用 data-src + IntersectionObserver 主动控制生命周期：

• HTML 中彻底删掉 src，只留占位样式（如 height: 400px; background: #f5f5f5;）
• rootMargin 设为 "0px 0px 300px 0px"，提前触发，避免用户刚看到边框才开始加载
• 回调中把 data-src 赋给 src 后，立即调用 observer.unobserve(iframe)，否则滚动来回会重复加载
• 若 iframe 可复用（如 tab 切换），加载完成后加 data-loaded="true"，下次直接 iframe.style.display = "block"
• 务必监听 iframe.onload 再做状态更新；但 contentWindow 可访问性需额外判断，不能仅靠 onload 就发 postMessage

---

广告或动态插入的 iframe 怎么处理

这类 iframe 基本不适用 loading="lazy"：

anything-to-html

将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。

下载

• 广告 SDK 动态插入的 iframe —— 浏览器压根不解析它的 loading 属性
• 容器必须用 <div class="ad-slot" data-ad-unit="/123/home_top"></div>，不写任何 iframe 标签
• 创建 iframe 时必须设 sandbox="allow-scripts allow-popups"，防止广告脚本污染主域
• src 注入后，必须手动调用广告 SDK 的 refresh() 或 display() 方法，否则不计费也不展示
• 必须预留固定宽高（如 height: 250px），否则触发 CLS（布局偏移），影响 Core Web Vitals

---

关键点容易被忽略：
iframe 卡顿常常不是加载慢，而是内部页面太重——比如嵌入页照搬了主站的整套 Vue/React 包、路由、权限校验逻辑。一个本该轻量的嵌入页，拉下 3MB 资源，再怎么优化加载时机也救不回来。真正要动刀的地方，往往在子页面自身。

立即学习“前端免费学习笔记（深入）”；