不是降级失效，而是file://协议下loading="lazy"被浏览器直接忽略，JS未禁用但路径解析失败导致图片不显示；必须用Live Server等HTTP服务（如http://127.0.0.1:5500）才能触发原生懒加载逻辑。

本地打开HTML时图片不显示，是不是降级失效了？

不是降级失效，是根本没触发降级——loading="lazy" 在 file:// 协议下被浏览器直接忽略，而 里的内容也不会渲染，因为 JS 本身没被禁用，只是你双击打开了文件。本地调试时，浏览器压根没走“降级路径”，它连 src 都懒得解析（尤其当路径含空格或大小写不匹配时），直接报 404 或静默失败。

怎么让本地环境真正模拟降级场景？

必须绕过 file:// 协议限制，用最小 HTTP 服务启动页面。VS Code 的 Live Server 插件是最轻量的选择，它起的是 http://127.0.0.1:5500/ 服务，此时：loading="lazy" 才会按规范行为工作； 内容在禁用 JS 后可验证；相对路径解析也和线上一致。

• 安装 Live Server 插件后，右键 HTML 文件 → “Open with Live Server”
• 手动禁用浏览器 JS：Chrome 地址栏输入 chrome://settings/content/javascript → 关闭开关 → 刷新页面
• 别用系统自带的“在浏览器中打开”，那永远卡在 file:// 里

降级逻辑里最容易漏掉的硬性条件

很多同学写了 data-src 却忘了最关键的兜底：src 必须指向一个真实可加载的资源。本地调试时，如果 src 是空值、./placeholder.gif 但文件不存在、或写成 src="data:image/gif;base64,R0lGODdhAQABAPAAAP8AAAAAACwAAAAAAQABAAACAkQBADs" 这种 base64 占位图却拼错字符，都会导致降级后白屏——因为浏览器不会报错，只会安静地不渲染。

DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur

下载

• src 值必须是有效路径或合法 base64 字符串，建议优先用 1×1 透明 GIF 文件（比 base64 更易排查）
• data-src 必须在 HTML 源码里静态存在，不能靠 JS 动态写入，否则断网或 JS 失败时它就不存在
• 检查 Network 面板里图片请求：若看到 placeholder.gif 返回 200，但高清图 data-src 路径 404，说明降级链路只走了一半

为什么用 display: none 包裹图片会让降级彻底失效？

这不是 bug，是 Safari 和多数 Android WebView 的明确行为：loading="lazy" 会跳过所有 display: none 状态下的 元素，哪怕你之后用 JS 改成 block，它也不会重新触发加载。本地调试时，这个 CSS 陷阱比 JS 逻辑错误更难发现，因为控制台无报错，Network 里也看不到请求。

• 改用 opacity: 0 或 visibility: hidden 替代 display: none，它们不影响懒加载触发
• 如果必须隐藏容器，把 display: none 加在父级
  上，而不是直接加在 标签上
• 本地调试时，临时删掉相关 CSS，确认图片能正常加载后再加回
真正的降级不是“JS 不行了就不管”，而是确保每张图在任意协议、任意 JS 状态、任意 CSS 条件下，都有至少一条确定可走的加载路径——本地调试阶段，最容易被忽略的就是这条路径是否真的“物理存在”。