pdf-lib
本篇范围
本篇聚焦 pdf-lib —— 用纯 JavaScript 创建并「修改既有」PDF 的库，可在浏览器、Node、Deno、React Native 等任意 JS 运行时工作。重点在：PDFDocument.create（新建）vs PDFDocument.load（载入既有） 的双入口、修改既有 PDF（加删页 / 合并 copyPages / 整页复用 embedPage）、表单 AcroForm 的填写与扁平化 flatten、drawText/drawImage/drawRectangle 等绘制、嵌入字体（标准 14 字体只支持 Latin，中文需 @pdf-lib/fontkit + embedFont）、save() → Uint8Array、以及与 jsPDF 的取舍。版本基线 1.17.1，并在关键处点明 「原库维护停滞、活跃 fork 是 @cantoo/pdf-lib」 这个高频现状。
pdf-lib 的官方定位是「Create and modify PDF documents in any JavaScript environment」——它最大的卖点不是「新建 PDF」（那很多库能做），而是修改一份既有 PDF：load 进来后加页、画字、盖章、填表单、合并，再 save 出去。这一能力让它在 JS 生态里独占「修改既有 PDF」生态位：同类的 jsPDF 只能从零新建、不能编辑既有文件；PDF.js 是 Mozilla 的渲染/解析库，负责把 PDF 画到 canvas，也不做编辑。pdf-lib 是纯 JS、零原生依赖，因此「runs everywhere」：浏览器、Node、Deno、React Native 同一套 API。
理解 pdf-lib 的关键是它的 「绘制式」心智模型：你不是在「编辑文档对象树」，而是在页面坐标系上叠加绘制——page.drawText/drawImage/drawRectangle 把新内容画在既有内容之上。坐标系沿用 PDF 规范：原点在左下角、y 轴向上（与 canvas/CSS 相反，是头号新手坑）。一个必须记牢的现状：原仓库 Hopding/pdf-lib 的 npm 最新稳定版长期停在 1.17.1（2021 年底）、维护基本停滞，但每周下载量仍有数百万；社区维护的活跃 fork 是 @cantoo/pdf-lib（已发到 2.x），需要新特性/修复时常作为 API 兼容的替代。
评价
优点
- 能修改既有 PDF：
load后加删页、合并、盖章、填表单——这是它区别于 jsPDF 的核心，也是 JS 生态里的稀缺能力 - 环境无关、零原生依赖：浏览器（
fetch().arrayBuffer()+ Blob 下载）与 Node（fs读写）同一套 API，还支持 Deno / React Native - 表单能力完整：
getForm后可读写文本框/复选框/单选/下拉/列表，支持填写与 flatten 扁平化（固化为不可编辑） - 整页复用独特：
embedPage/embedPdf把整页变成可重复绘制的对象，drawPage叠加，天然适合图章、水印、N-up 拼版 - 自带 TypeScript 类型：API 有完整提示，无需额外 @types
- 绘制 API 直观：
drawText({ x, y, size, font, color })一行到位，颜色用rgb/cmyk/grayscale辅助函数
缺点
- 原库维护停滞：稳定版停在 1.17.1（2021），新特性/修复需转向社区 fork
@cantoo/pdf-lib（这是新手最该知道的现状） - 不抽取文本、不渲染：读不出 PDF 里已有的文字（那是 PDF.js 的活），也不把 PDF 画到屏幕
- 不能就地改写原文字：drawText 只能叠加新内容，无法定位并修改既有文本对象
- 不支持加密 PDF：load 加密文件抛
EncryptedPDFError，ignoreEncryption也不解密 - 中文需自备字体：标准 14 字体只覆盖 WinAnsi(Latin)，写中文必须
registerFontkit+ 嵌入 CJK 字体，且建议subset:true控体积 - 不渲染 HTML/CSS：它是底层绘制库，「HTML → PDF」要用 Puppeteer(
page.pdf()) 等无头浏览器方案 - 图片仅 PNG/JPEG：且 JPEG 偏向 baseline，渐进式 JPEG 易出问题
文档地址
GitHub 地址
Hopding/pdf-lib（活跃 fork：cantoo-scribe/pdf-lib）