Yii框架延迟加载技巧与优化方法

Yii框架虽无原生“延迟加载”机制，但通过灵活组合defer/async脚本控制、AssetBundle批量配置、AR关联预加载（with）及动态script插入等手段，可精准实现非关键资源的按需加载——既避免首屏阻塞、提升渲染性能，又规避N+1查询风险与服务端渲染误区；本文直击实践痛点，提供可落地的优化方案与易踩坑预警，助你真正掌控资源加载时机。

Yii 框架本身没有叫“延迟加载”的内置机制，但你真正想解决的，是「非关键资源不阻塞首屏渲染」——也就是 JavaScript 的 defer / async、CSS 的异步加载、以及关联数据的懒查（Lazy Loading）这三类问题。直接上方案，不绕弯。

registerJsFile() 中设置 async 或 defer

这是最直接控制 JS 加载时机的方式，适用于第三方统计、埋点、非首屏功能脚本。注意：async 和 defer 行为不同：

• async：下载不阻塞 HTML 解析，下载完立即执行（可能早于 DOM 构建完成）
• defer：下载不阻塞解析，但执行会等到 DOM 解析完毕、DOMContentLoaded 之前

推荐对纯逻辑型脚本用 defer，对独立上报类脚本用 async：

$this->registerJsFile('@web/js/analytics.js', [
    'async' => true,
    'position' => \yii\web\View::POS_END
]);

⚠️ 容易踩的坑：position 必须设为 POS_END，否则 async/defer 属性不会被写入