HTML代码转成图片不显示，可能是由于以下原因导致的：HTML代码本身有错误：检查HTML语法是否正确，比如标签是否闭合、属性是否正确使用等。图片生成工具问题：如果你是通过某些在线工具或代码将HTML转换为图片，可能是工具不支持某些HTML元素或样式。CSS样式未生效：如果HTML中使用了CSS样式，但图片生成时没有正确渲染样式，可能导致内容无法显示。字体或资源缺失：如果HTML中使用了外部字体或

本文深入剖析了HTML转图片过程中常见“空白、白图、样式丢失、模糊失真”等问题的根本原因，指出问题并非代码错误，而是跨域资源加载失败、CSS特性兼容性限制（如transform/filter）、DOM可见性异常、字体未就绪、CSS变量与媒体查询解析偏差、以及设备像素比（DPR）未适配等隐性陷阱；并针对html2canvas、dom-to-image、Puppeteer/Playwright等主流方案，给出可落地的实操对策——从确保元素可见与同源/CORS配置，到等待字体加载、内联CSS变量、禁用干扰样式规则，再到服务端复用浏览器实例、正确设置deviceScaleFactor与viewport，全方位覆盖前端与后端生成场景，帮助开发者精准定位、高效解决HTML截图“看似正常却渲染失败”的顽疾。

用 html2canvas 渲染页面区域却空白或只出白图

常见现象是调用 html2canvas 后返回的 canvas 是纯白的，或者只渲染出部分元素（比如文字没了、背景色消失、SVG 不见）。根本原因不是代码没跑，而是它无法跨域加载资源、不支持某些 CSS 属性、且对 DOM 状态敏感。

实操建议：

• 确保目标 DOM 元素已完全挂载且可见（display: none 或 visibility: hidden 的容器会被跳过）
• 图片资源必须同源，或服务端已配置 CORS 头（否则 html2canvas 会静默失败，不报错但 canvas 空白）
• 避免使用 transform: scale()、filter、mask 等未被完全支持的 CSS 特性；可临时加 html2canvas({ useCORS: true, allowTaint: false })
• 如果内容含 Web Font，需等字体加载完成再调用 —— 用 document.fonts.ready.then(...) 包裹

dom-to-image 导出 SVG 或 PNG 时样式丢失

这个库比 html2canvas 更依赖 CSSOM 解析，一旦遇到内联样式优先级冲突、CSS 变量未展开、或 @media 查询生效但当前视口不匹配，就容易漏样式。

实操建议：

• 不要依赖 !important 或动态插入的 style 标签；把关键样式提前写进