详情页图片降级必须确保src始终指向真实可用资源,因不支持loading="lazy"的浏览器会忽略该属性且不读取data-src,若src为空、错误或被css隐藏则图片彻底不渲染;src应为ssr生成的低质jpg,data-src须静态存在于html中,关键图需禁用懒加载并设fetchpriority="high"或preload。

详情页图片降级必须让每张图在 JS 失效、断网、旧浏览器或格式不支持时,仍能加载一张可用图——核心是 src 永远不空、不假、不依赖运行时逻辑。
为什么不能只靠 loading="lazy" + data-src
浏览器不支持 loading="lazy"(如 Safari ≤15.3、部分安卓 WebView)时,会直接忽略该属性,但不会读取或赋值 data-src。此时若 src 是空、"#"、"placeholder.svg"(路径错误)、或被 CSS 隐藏(display: none),图片就彻底不渲染,详情页关键信息直接消失。
-
src必须指向一个真实可访问的资源:推荐 SSR 渲染出的低质量 JPG(如 400px 宽),而非 1×1 GIF 或 base64 占位符 -
data-src必须静态存在于 HTML 源码中(不能由 JS 拼接或异步注入),否则断网时它根本不存在 - 关键图(如商品主图、参数图、细节放大图)建议跳过懒加载:直接写死
src,不加loading="lazy",也不设data-src
<picture></picture> 里 <img> 的 src 不是“备用”,是最终渲染载体
<source></source> 加载失败(404、超时、MIME 类型错)时,浏览器**不会自动 fallback 到 <img>**;它只在“无匹配 <source></source>”时才用 <img>。也就是说,media 条件满足但 AVIF 路径返回 404,页面就留白。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
-
<img>的src必须是高可用兜底地址(如 CDN 上稳定的 JPG),不能是相对路径./fallback.jpg(嵌套路由下易 404) - 推荐内联
onerror做轻量兜底:onerror="this.src='/images/fallback.jpg'; this.onerror=null;",this.onerror=null必须写,否则循环触发 -
<img>的alt不可为空字符串,需准确描述图内容(如alt="iPhone 15 Pro 钛金属边框特写"),否则无障碍和 SEO 全失效
服务端 MIME 类型配错,<source type="image/avif"></source> 会静默失效
即使 HTML 写得完全正确,如果服务器返回 AVIF 文件时 header 中的 Content-Type 是 image/jpeg 或 application/octet-stream,Chrome 和 Firefox 会直接跳过该 <source></source>,连 error 事件都不触发——用户看到的是 fallback JPG,但你根本不知道降级发生了。
- 验证方法:DevTools → Network → 点开 AVIF 请求 → 查看 Response Headers 中的
Content-Type是否精确等于image/avif - WebP 对应
Content-Type: image/webp,JPG/PNG 保持默认即可,但别让 Nginx 或 CDN 把 AVIF 当作二进制流返回 - 所有格式图片的宽高、裁剪比例、压缩质量必须一致,否则切换时视觉跳变(CLIP)直接影响详情页可信度
首屏关键图必须禁用 loading="lazy",并显式设 fetchpriority="high" 或 <link rel="preload">
详情页首屏图(如商品主图、价格图、购买按钮背景)若被 lazy 加载,在 Safari ≤15.3 或某些 WebView 中可能被完全跳过,导致白屏或布局抖动。
- 必须写
loading="eager",防止浏览器启发式策略误判 - 对 Chromium 112+,加
fetchpriority="high"是 LCP 稳定性的关键提示;但若已用了<link rel="preload" as="image" href="main.jpg">,则无需再加,二者选其一即可 -
<link rel="preload">的href必须与最终<img>的src完全一致(含查询参数),否则预加载失效
真正难的不是写出正确的标签组合,而是确保每张图的 src 在任意网络、任意 UA、任意 JS 状态下都指向一个真实存在且可解码的资源——其他所有优化,都建立在这个前提之上。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










