【免登录下载】pdf.js 前端插件:3 步实现 PDF 在线预览,访客零安装直接看文档

原创2026-10-27 12:02:361,683 阅读
文章标签:前端

【免登录下载】pdf.js 前端插件:3 步实现 PDF 在线预览,访客零安装直接看文档

pdf.js 前端插件解决的就是网页无法直接打开 PDF 在线预览的难题:把 PDF 地址拼进一行代码,访客就能在浏览器里查看文档,不用下载任何额外软件。

项目定位与核心能力

它本质上是一个开箱即用的 pdf.js 前端资源包,解压后即得到 pdfjs 目录,内含核心渲染脚本 build、预览页 web/viewer.html 以及中文编码映射文件 cmaps。只要你的网站想把 PDF 文档展示给用户,而不希望对方装阅读器或手动下载,都可以直接接入。无论企业官网、资料库还是个人博客都适用。

  • 一行代码即可在新窗口弹出预览页,接入成本极低
  • 渲染完全跑在浏览器里,用户端无需安装任何软件
  • 自带中文 cmaps 映射,中文 PDF 也能正常显示

👇 下面是 pdf.js 快速上手步骤。

快速上手(4 步完成)

  1. 把仓库里的 pdfjs.zip 解压,将得到的 pdfjs 目录整个放到网站静态目录下(例如 www/pdfjs/)。

  2. 确认要展示的 PDF 有一个浏览器能直接访问的网络地址。

  3. 在页面的按钮事件里执行这一行:

    window.open(basePath + '/pdfjs/web/viewer.html?file=' + fileUrl);

  4. 点击按钮,预览窗口即弹出。这里 basePath 是 pdfjs 目录在网站中的地址,fileUrl 是待预览 PDF 文件的完整网址。

常见问题与注意

  • 预览页 404 或白屏:多半是 basePath 与服务器上 pdfjs 目录的实际位置对不上,改成真实路径即可。
  • 窗口能打开但 PDF 加载不出来:检查 fileUrl 是否为浏览器可访问的 URL,跨域资源还要允许跨域(CORS)请求。
  • 老旧浏览器显示异常:插件依赖较新的 JavaScript 能力,建议引导用户使用主流浏览器的最新版。
  • 中文 PDF 字体错乱:请确认部署时把 pdfjs/web/cmaps 目录一并带上了,缺了映射文件中文就无法正确渲染。

更多背景可参考 README.md。

一行代码,让 PDF 在线预览变成你的站点标配。愿你的文档展示从此不再踩坑!

登录后查看全文
pdf.js前端插件在线预览PDF文件的利器