Vue.js 图片懒加载指令基于 Intersection Observer API 实现，支持 Vue 2/3，含兼容降级、错误处理与轻量性能监测，兼顾复用性、性能与体验。
Vue.js 中实现图片懒加载指令，核心是利用 Intersection Observer API 替代监听 scroll 事件，避免频繁重排重绘；封装为自定义指令可复用、解耦业务逻辑，并配合性能监测（如首次渲染时间、加载成功率、资源耗时）能真实反映优化效果。
懒加载指令基础封装（支持 Vue 2 / 3）
以 Vue 3 的 v-lazy 指令为例，使用 mounted 和 unmounted 钩子管理观察器生命周期：
- 指令接收
value（图片真实 src）和arg（可选占位图或 loading 状态类名） - 创建
IntersectionObserver，阈值设为0.05（元素进入视口 5% 即触发） - 回调中调用
el.src = value，并移除指令绑定的 class（如lazy-loading） - 在
unmounted中调用observer.unobserve(el)防止内存泄漏
兼容性兜底与错误处理
对于不支持 Intersection Observer 的旧浏览器（如 IE），需降级为 scroll + getBoundingClientRect 方案：
- 检测
window.IntersectionObserver是否存在，不存在则 fallback 到节流 scroll 监听 - 图片加载失败时，触发
error事件，可替换为默认占位图或上报异常 - 添加
loading="lazy"属性作为原生懒加载后备（现代浏览器自动启用）
嵌入轻量性能监测点
在指令内部埋点，不依赖外部 SDK，聚焦关键指标：
立即学习“前端免费学习笔记（深入）”；
-
首次进入视口时间：记录
observer回调触发时刻（performance.now()） -
加载耗时：从设置
el.src开始，监听load或error，计算差值 -
加载成功率：统计成功/失败数量，按页面维度聚合后通过
console.table或sendBeacon上报
实际使用与优化建议
在模板中直接使用，保持语义清晰：
<img v-lazy="item.src" :alt="item.alt">- 支持动态更新：当
v-lazy绑定值变化时，自动重新加载（需在updated钩子中处理） - 避免对大量图片同时初始化 observer，可加防抖或分批 observe（如每 10 张一组）
- CSS 预留宽高或使用 aspect-ratio，防止懒加载触发时布局抖动（CLS 优化）
