5分钟上手pdf-lib：JavaScript PDF处理全指南 📄✨

欢迎使用pdf-lib！这是一个功能强大的JavaScript库，让你能在任何JavaScript环境（包括Node.js、浏览器、Deno和React Native）中轻松创建和修改PDF文档。无论你是要生成报告、处理表单还是编辑现有PDF，这个工具都能满足你的需求。

🚀 准备工作：安装与环境配置

快速安装步骤

你可以通过npm或yarn轻松安装pdf-lib：

# 使用npm安装
npm install --save pdf-lib

# 或使用yarn
yarn add pdf-lib

如果你需要处理自定义字体，还需要安装fontkit插件：

npm install --save @pdf-lib/fontkit

环境兼容性说明

环境	支持情况	特殊说明
Node.js	✅ 完全支持	适合后端PDF处理
浏览器	✅ 完全支持	可直接在网页中操作PDF
Deno	✅ 完全支持	需要导入ES模块
React Native	✅ 部分支持	需额外配置文件系统访问

📝 核心功能入门

创建新PDF文档

创建一个空白PDF文档只需三行代码：

import { PDFDocument } from 'pdf-lib';

// 创建新文档
const pdfDoc = await PDFDocument.create();

// 添加页面
const page = pdfDoc.addPage([550, 750]); // 宽度550，高度750

// 保存PDF
const pdfBytes = await pdfDoc.save();

修改现有PDF文档

你可以加载已有的PDF文件并进行编辑：

// 加载现有PDF
const pdfDoc = await PDFDocument.load(existingPdfBytes);

// 获取第一页
const pages = pdfDoc.getPages();
const firstPage = pages[0];

// 在页面上添加文本
firstPage.drawText('这是用JavaScript添加的文本！', {
  x: 50,
  y: 50,
  size: 24,
  color: rgb(1, 0, 0), // 红色
});

🎨 实战技巧：常用功能示例

添加文本与字体处理

pdf-lib支持标准字体和自定义字体：

// 使用标准字体
const helveticaFont = await pdfDoc.embedFont(StandardFonts.Helvetica);

// 或嵌入自定义字体
import fontkit from '@pdf-lib/fontkit';
pdfDoc.registerFontkit(fontkit);
const customFont = await pdfDoc.embedFont(customFontBytes);

// 绘制文本
page.drawText('Hello World!', {
  x: 100,
  y: 700,
  size: 30,
  font: helveticaFont,
  color: rgb(0, 0.53, 0.71),
});

插入图片

你可以轻松地将PNG和JPEG图片添加到PDF中：

// 嵌入图片
const pngImage = await pdfDoc.embedPng(pngImageBytes);
const jpgImage = await pdfDoc.embedJpg(jpgImageBytes);

// 绘制图片
page.drawImage(pngImage, {
  x: 50,
  y: 500,
  width: 200,
  height: 200,
});

表单处理

创建和填充PDF表单变得简单：

// 获取表单
const form = pdfDoc.getForm();

// 创建文本字段
const textField = form.createTextField('username');
textField.setText('John Doe');
textField.addToPage(page, { x: 50, y: 600 });

// 创建复选框
const checkBox = form.createCheckBox('agree');
checkBox.check();
checkBox.addToPage(page, { x: 50, y: 550 });

💡 专业技巧：提升PDF处理效率

页面操作高级技巧

• 复制页面：在文档间复制页面时使用copyPages方法

  const [copiedPage] = await pdfDoc.copyPages(otherPdfDoc, [0]);
  pdfDoc.addPage(copiedPage);
  

• 调整页面顺序：使用insertPage方法控制页面位置

  pdfDoc.insertPage(0, copiedPage); // 插入为第一页
  

性能优化建议

1. 处理大文件：加载大型PDF时使用parseSpeed选项

   const pdfDoc = await PDFDocument.load(largePdfBytes, {
     parseSpeed: ParseSpeeds.Fastest
   });
   

2. 批量操作：处理多个PDF时复用资源，减少内存占用

3. 渐进式保存：对于大型文档，考虑分阶段保存

❓ 常见问题解答

为什么我的中文字体显示不正常？

这是因为PDF默认不包含中文字体。解决方案：

1. 嵌入支持中文的TrueType字体
2. 确保字体文件包含所需的中文字形

如何减小生成的PDF文件大小？

• 使用图片压缩
• 避免不必要的字体子集
• 合并重复资源
• 使用compress: true选项保存：

  const pdfBytes = await pdfDoc.save({ compress: true });
  

支持加密PDF文件吗？

pdf-lib可以加载和修改加密PDF，但需要提供密码：

const pdfDoc = await PDFDocument.load(encryptedPdfBytes, {
  password: 'pdf-password-123'
});

📚 进阶学习资源

官方文档与示例

• 完整API文档：docs/
• 示例代码集合：examples/

实用工具推荐

• PDF测试文件：assets/pdfs/
• 字体资源：assets/fonts/

社区支持

如果你遇到问题，可以：

1. 查看GitHub Issues
2. 加入Discord社区讨论
3. 提交PR贡献代码

现在你已经掌握了pdf-lib的基本用法！这个强大的库能帮助你在任何JavaScript项目中轻松处理PDF文件。无论是创建发票、生成报告还是处理表单，pdf-lib都能成为你的得力助手。开始尝试吧！