PDF 压平听起来简单，但很多人遇到压平后表单字段值变了、链接失效、或文件反而变大的问题。今天聊聊纯前端 PDF 压平的核心问题和解决方案。
PDF 压平的常见场景
| 场景 | 说明 |
|---|---|
| 合同定稿 | 签署后锁定所有字段，防止被修改 |
| 官方表格提交 | 政府/税务系统要求提交压平的 PDF |
| 归档保存 | 永久保存填写后的最终状态 |
| 防止误改 | 分享给同事时防止意外修改字段值 |
技术方案：pdf-lib 压平 PDF
核心实现
javascript
import { PDFDocument } from 'pdf-lib'
async function flattenPdf(arrayBuffer: ArrayBuffer): Promise<Uint8Array> {
const srcDoc = await PDFDocument.load(arrayBuffer)
// 使用 copy 方法并冻结字段值
const newDoc = await srcDoc.copy({
freezeFieldValues: true,
})
return await newDoc.save()
}关键点：copy() 与 freezeFieldValues
copy() 方法可以复制整个 PDF 文档，配合 freezeFieldValues: true 选项可以将表单字段的值永久写入页面内容：
csharp
const newDoc = await srcDoc.copy({
freezeFieldValues: true, // 冻结字段值
})关键点：检测表单字段数量
压平前检测文档中的表单字段和批注数量，让用户了解将有多少元素被压平：
ini
let fieldCount = 0
let annotationCount = 0
for (const page of pages) {
const fields = page.acroForm?.fields || []
fieldCount += fields.length
const annotations = page.getAnnotations()
annotationCount += annotations.length
}常见坑位
坑 1：链接失效
压平后嵌入在表单字段中的链接可能丢失。
解决方案：
- 压平前先备份原文件
- 重要链接可用"移除 PDF 链接"工具处理
- 检查压平后的重要链接是否保留
坑 2：不可逆操作
压平是不可逆的，一旦压平就无法恢复为可编辑表单。
解决方案：
- 压平前务必备份原始文件
- 确认所有字段填写正确后再压平
- 重要文档先用桌面工具测试
坑 3：文件体积变化
压平后文件可能略微变大，因为字段内容被渲染为页面内容。
解决方案：
- 压平后用压缩工具处理
- 检查输出文件大小是否可接受
- 大文件考虑分批处理
坑 4：复杂批注丢失
某些复杂批注类型（如 rich text 批注）可能无法正确压平。
解决方案：
- 检查压平后批注是否正确显示
- 复杂批注建议用桌面工具处理
- 或先移除批注再压平
坑 5：选择性压平困难
当前工具将所有元素一起压平，不支持选择性压平。
解决方案：
- 需要选择性压平时用桌面工具
- 或分步处理：先移除不需要压平的批注
压平 vs 其他操作的区别
| 工具 | 操作 | 适用场景 |
|---|---|---|
| 纯前端工具 | 一键压平所有交互元素 | 敏感文档、隐私优先 |
| 移除批注 | 删除批注但保留表单字段 | 清理批注 |
| 移除元数据 | 删除隐藏文档属性 | 隐私清理 |
| 加密 | 密码保护文件 | 限制访问 |
纯前端的优势是隐私安全，适合处理敏感文档。
使用建议
- 备份原文件：压平前务必备份
- 检查字段：确认所有字段填写正确
- 敏感文档本地处理：不要用上传式工具
- 检查输出：压平后检查内容和链接
总结
- PDF 压平核心是 冻结字段值 和 合并页面内容
- 简单表单效果好，复杂排版需要手动调整
- 纯前端方案适合 私密文档
- 压平前务必备份原始文件
搜索「PDF压平」即可找到纯浏览器端工具，文件不上传服务器。