HTML层兜底需写width/height或aspect-ratio防抖动，alt提供语义化fallback，<picture>中<img>为强制兜底，服务端可返回带文字占位图，全局error事件捕获漏网失败并上报，避免onerror内联写法以保障可维护性。

图片加载失败时如何用 HTML 层兜底

未加载图片不等于页面崩溃，但默认白块 + 布局塌陷会直接伤害体验。HTML 层的降级不是“等 JS 来救”，而是从结构上确保失败时仍有语义、有占位、不抖动。

• 必须写 width 和 height（或用 CSS aspect-ratio），否则加载前无占位，后续加载完成会触发布局重排（layout shift）
• alt 不是可选项：空 alt="" 会让失败图静默消失；写具体描述（如 alt="产品主图"）既是无障碍要求，也是视觉 fallback
• 用 <picture> 包裹 <img>，所有 <source> 失败后，最终的 <img src="..."> 会强制触发加载——这个 <img> 就是 HTML 层最后一道防线
• 服务端可配置 Nginx 返回带文字的占位图（如 /img/missing.png?text=404+logo），比纯白更易定位问题

如何用全局 error 事件捕获漏网的加载失败

不是所有图片都显式写了 onerror，动态插入或框架生成的图容易遗漏。全局监听能兜住这些边界情况，但要注意过滤和副作用。

• 注册时加 true 捕获阶段：window.addEventListener('error', handler, true)
• 只处理资源加载错误：用 !(event instanceof ErrorEvent) 过滤，JS 运行时错误（ErrorEvent）不应混入
• 从 event.target 取出失败元素，比如 event.target.src 或 event.target.href，可用于上报路径和状态码
• 不要在 handler 里调用 location.reload()——用户可能刚输完表单，应先提示再交由用户决定
• 建议配合 sessionStorage 记录同资源连续失败次数，2 次以上才触发告警或替换为静态占位图

本地开发时 file:// 协议下图片路径失效怎么绕

双击打开 HTML 文件走的是 file:// 协议，所有以 / 开头的绝对路径会被解析成系统根目录（如 file:///style.css），而非项目根目录。这不是代码 bug，是协议限制。

anything-to-html

将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。

下载

• 全部改用相对路径，且以当前 HTML 文件所在目录为基准（如 ./images/logo.jpg）
• 避免混用 ./images/ 和 images/：前者明确当前目录，后者在某些浏览器中可能被解析为根目录
• 开发阶段可用简易 HTTP server 替代双击：Python 的 python -m http.server 或 VS Code Live Server 插件
• 若必须用 file://，路径统一写成 images/logo.jpg（不加 ./），并确保所有 HTML 都放在项目根目录下运行

为什么 onerror 内联写法要避免

<img onerror="this.src='/placeholder.svg'"> 看似简洁，实则隐患多：每次错误都要重新解析字符串，无法复用逻辑，也难以做条件判断或上报。

立即学习“前端免费学习笔记（深入）”；

• 内联 handler 是字符串，不是函数，无法访问闭包变量或执行复杂逻辑
• 重复绑定多个相同逻辑时，每个 img 都要写一遍，维护成本高
• 无法统一控制降级策略（如按失败次数分级：第 1 次换占位图，第 2 次上报，第 3 次隐藏）
• 推荐方式：全局遍历一次 document.querySelectorAll('img')，统一绑定 error 事件处理器
• 开发期快速排查：在控制台跑 Array.from(document.images).filter(i => i.naturalWidth === 0)，直接列出所有加载失败的 img

真正容易被忽略的是：降级不是“JS 加载失败时的补救”，而是“无论 JS 是否存在、是否执行成功，HTML 本身就得能稳住”。<picture> 的兜底 <img>、alt 文本、宽高属性、相对路径约定——这些才是不依赖任何运行时环境的硬保障。