Yii框架无内置“延迟加载”，但可通过defer/async控制JS加载、AssetBundle批量配置jsOptions、AR预加载with()及动态插入script实现非关键资源不阻塞首屏。
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 属性不会被写入 <script> 标签；若设为 POS_HEAD，即使加了 async，也仍可能因位置靠前引发竞态问题。
AssetBundle 中批量配置 jsOptions
当你有一整包 JS（比如某个页面专用的图表库 + 初始化代码），想统一启用 defer，就别一个个手写 registerJsFile()，改 AssetBundle 更干净：
class CheckoutAsset extends \yii\web\AssetBundle
{
public $basePath = '@webroot';
public $baseUrl = '@web';
public $js = [
'js/chart.js',
'js/checkout-init.js'
];
public $jsOptions = ['defer' => true]; // ← 全局生效
}
⚠️ 注意两点：
-
$jsOptions是整个 AssetBundle 的默认选项，不能给单个 JS 文件单独设async；如需混用，得把那个特殊文件拆出来，用registerJsFile()单独注册 - 如果该 AssetBundle 还依赖其他 Bundle（比如依赖
yii\web\JqueryAsset），而后者没设defer，那 jQuery 仍会同步加载——顺序和依赖关系会影响最终行为
ActiveRecord 关联字段的“假延迟加载”与真实优化
很多人误以为 Yii 的 $model->relation 是“延迟加载”，其实它只是懒执行查询（Lazy Load），但一旦访问就会立刻触发 SQL，且无法控制时机。这不是前端意义的“延迟”，而是典型的 N+1 风险点。
真正要做的，不是等访问时再查，而是提前预判、按需预载：
- 列表页展示用户头像？用
with('profile')一次性查出，而不是循环里逐个访问$user->profile->avatar - 详情页才需要地址信息？那就只在详情 Action 里
->with(['address', 'orders'])，列表页完全不带 - 极端情况需彻底规避关联访问，可用
asArray()+ 原生 JOIN 查询替代 AR 对象构建，减少内存开销
⚠️ 关键提醒：不要在视图里写 $model->relation->field 并幻想“它会自动延迟到滚动进视口才加载”——PHP 是服务端渲染，所有数据在响应发出前就已确定。所谓“延迟”，必须由你在控制器层主动决策、分场景加载。
动态插入 script 标签实现真·运行时加载
适用于真正需要“用户交互后才加载”的模块，比如点击「展开更多评论」后才加载评论组件 JS：
$this->registerJs("
document.getElementById('load-comments-btn').addEventListener('click', function() {
const s = document.createElement('script');
s.src = '" . \yii\helpers\Url::to('@web/js/comments-widget.js') . "';
s.defer = true;
document.body.appendChild(s);
});
", \yii\web\View::POS_READY);
这种方式绕过 Yii 资源管理，完全由前端控制时机。但代价是失去 AssetBundle 的版本哈希、CDN 自动替换、压缩合并等能力。
复杂点在于：如果这个动态脚本又依赖 jQuery 或其他全局变量，你得确保它们已就绪；更稳妥的做法是封装成 Promise 或用 onload 回调做依赖链处理——这点容易被忽略，一上来就报 jQuery is not defined。
