WordPress上传PDF文件并显示：3种方法一看就会

在做外贸独立站的时候，很多需要做公司官网，那就少不了公司宣传或者PDF这类文件的下载，很多人第一次往 WordPress 里放 PDF（产品手册、报价单、白皮书）时，会卡在两个地方：文件传不上去，或者传上去了页面上只有一行蓝色链接。这篇文章把”上传”和”显示”拆开讲，再给出报错的排查顺序。

PDF 上传到 WordPress：先走媒体库

WordPress 不需要装额外的插件就能上传 PDF。进入后台 媒体 → 添加媒体文件，把文件拖进去即可，上传完成后点开文件，能看到”文件网址”。

显示 PDF 的三种方式，怎么选

方式	适合场景	是否需要插件
文字链接	只想让访客点开或下载	否
文件块（File）+ 内嵌显示	想让访客直接在页面里看	否
PDF 阅读器插件	需要翻页、缩放、全屏等工具栏	是

页数不多、只想让访客看一眼，用文件块就够了。需要翻页和缩放的长文档，再考虑插件。

方法一：用文字链接放 PDF

在媒体库里复制 PDF 的文件网址，回到文章里选中一段文字，用链接按钮粘贴进去即可。访客点击后，浏览器会按自己的设置打开或下载这个文件。

这种方式最稳，不依赖任何块或插件，缺点是显示效果最朴素。

方法二：用文件块在页面里直接显示 PDF

在区块编辑器里添加 文件（File） 块。

选择刚上传的 PDF，然后在右侧设置里打开 显示内嵌 。打开后可以用滑块或像素值调整显示高度。

• 显示下载按钮：开启时出现下载按钮，关闭后只显示文件名链接。
• 在新标签页打开：让文件或附件页面在新标签页打开。

如果你用 Elementor 建站，不同编辑器的操作入口不一样，可以先看这篇对比：Elementor vs Gutenberg：2026年该用哪个WordPress编辑器？深度对比。

方法三：用插件做 PDF 阅读器

文件块只提供基础预览。需要翻页、缩放、全屏、下载工具栏时，常见做法是装 PDF 阅读器类插件，比如 Document Engine，它有免费版。

装插件之前先想一下：页面上每多一个插件，就多一份维护成本。选插件的思路可以参考：WordPress必装插件2026：外贸建站必备的15个插件。

PDF 显示不出来或上传失败：4步排查

第 1 步：文件太大，先看上传限制

上传报错、进度条走到一半失败，常见原因是服务器上传限制。WordPress 本身不限制 PDF 大小，限制来自主机或服务器配置。upload_max_filesize 和 post_max_size 需要一起调大。如果您是宝塔面板可以查看对比下图设置PHP配置。

宝塔、VPS 和共享主机的具体改法，这篇已经写全了：WordPress上传文件大小限制怎么改？5种方法完整教程，宝塔/VPS/共享主机都适用。

第 2 步：用 Nginx 的站点要再看一处

用 Nginx 的服务器，除了 PHP 的限制，还有 Nginx 自己的 client_max_body_size，它需要不小于 PHP 的上传限制（来源：WP Engine）。如果上传时看到 413 Request Entity Too Large，大概率就是这一项。

server {
    client_max_body_size 64M;
}

改完后先运行 nginx -t 检查语法，再重载。数值按你的 PDF 实际大小定，不必照抄 64M。

说明：413 对应 Nginx 默认上传体积偏小这一点，我本次没有逐条核实官方文档，属于通用经验，改之前以你服务器的实际报错为准。

第 3 步：提示”文件类型不允许”

遇到”文件类型不被允许”一类的提示，可以联系您购买主机的主机商确认是否开启了 PDF 上传。除了主机限制，安全类插件或自定义规则也可能拦截上传，需要你在自己站点上逐个停用排查。

第 4 步：内嵌区域一片空白

先把文件块的”显示内嵌”关掉，改成下载按钮或文字链接，确认文件本身能打开。能打开说明 PDF 没问题，是内嵌显示的问题，这时可以换成插件尝试。文件太大也不适合内嵌：大于750MB 的 PDF 可能被提示”太大无法预览”，建议改放到第三方存储再链接，或者直接放下载链接。

显示 PDF 前先想清楚这几件事

• 移动端体验：很多手机浏览器对内嵌 PDF 的显示不稳定，重要文档建议同时保留下载按钮。
• 文件大小：PDF 越大，页面和服务器压力越大。上传前先压缩。
• 存放位置：PDF 会占用主机空间。主机性能和空间不够时，页面加载会受影响，可以参考我整理的 WordPress 主机推荐。
• 访问权限：媒体库里的文件网址是公开的，知道链接的人都能打开。需要保密的文件，不要直接放进媒体库。

常见问题