embed标签在2026年已不可靠，仅当src有效、type="application/pdf"且宽高为具体值时偶有残余支持；推荐改用iframe或object嵌入PDF。
embed 标签在 2026 年已不是可靠方案，仅当满足三个硬性条件时才可能“偶然显示”，多数情况下会静默失败——尤其在 Safari、移动端、或本地双击打开 HTML 时。
为什么 embed 经常空白却不报错
浏览器不会提示“PDF 加载失败”，而是直接留白或降级为下载链接。常见现象包括：
- Safari（macOS 14+/iOS）控制台无错误，但只显示空框
- Chrome 中 PDF 显示一半后卡住，或点击后触发下载而非预览
- 本地用
file://协议双击打开 HTML，所有浏览器均不加载 PDF
根本原因不是代码写错，而是现代浏览器对 embed 的支持已退化为“兼容性残留”：它依赖底层 MIME 类型识别 + 固定尺寸 + 同源 HTTP(S) 上下文，三者缺一不可。
embed 能用的最小可行写法
若你必须用 embed（例如内网旧系统、定制 Chromium 内核环境），请严格满足以下全部条件：
-
src必须是相对当前 HTML 的有效路径，且服务端返回状态码200 OK，Content-Type为application/pdf（不能是text/plain或application/octet-stream） -
type属性必须显式写成application/pdf；写成pdf、application/x-pdf或直接省略，都会失效 -
width和height必须是具体值，如width="800px"或width="100%"；height="auto"在所有主流浏览器中均被忽略，导致高度塌陷 - 不能嵌套在
<object>内，也不能加<noembed>—— 这类“兜底”逻辑反而触发 Safari 更严格的拦截
最小可用示例：
<embed src="manual.pdf" type="application/pdf" width="100%" height="600px">
替代 embed 的更稳方案
实际项目中，应优先放弃 embed，改用以下任一方式：
-
<iframe src="doc.pdf">：同域 PDF 最简替代，渲染更稳定，fallback 行为明确（不支持时自动下载） -
<object data="doc.pdf" type="application/pdf"><p>不支持预览</p></object>：提供 fallback 文本，语义更清晰，部分老系统兼容更好 - 跨域或需深度控制时，用
pdf.js：完全脱离浏览器内置 PDF 渲染器，支持分页、搜索、文本提取等，但需额外引入 JS 和 worker
Google Docs Viewer 可作为最后兜底（需 PDF 公网可访问），但注意其 URL 必须 encodeURIComponent 编码，且不适用于内网或敏感文档。
容易被忽略的调试关键点
很多问题不是代码问题，而是环境或配置层面的盲区：
- 永远别用双击打开 HTML 文件测试 —— 必须启动本地服务器（如
python3 -m http.server） - 检查 Network 面板里 PDF 请求的响应头：
Content-Type是否为application/pdf，不是则说明服务器没配 MIME 类型 - HTTPS 页面加载 HTTP PDF 会因混合内容被阻止，Safari 尤其严格
- iOS Safari 几乎不渲染任何
embed或object中的 PDF，iframe也大概率只显示下载按钮
真正可靠的预览，从来不是靠一个标签写对，而是靠路径、协议、MIME、跨域策略和终端能力这五者的对齐。
