关键词:图片转 PDF、pdf-lib、FileSaver.js、多图合并、本地处理、纯前端、JavaScript、Canvas
一、背景与需求
日常生活和工作中,经常需要把多张图片合并成一个 PDF 文件:身份证正反面、银行流水截图、发票照片、手写笔记扫描件等。分开发送不方便,合并在一起又很麻烦。
现有的图片转 PDF 工具普遍存在以下问题:
- 图片需上传到第三方服务器,身份证、发票、银行卡等敏感图片泄露风险高;
- 多数工具只能按上传顺序合并,无法调整图片顺序,合并后发现顺序错了还要重新上传;
- 页面尺寸与边距固定,不适合打印或装订场景;
- 部分工具需要安装客户端、注册登录,或加水印、限制转换次数。
基于此,我开发了 Toolion 图片批量转 PDF 工具(项目地址:toolion.cn/image-to-pd… PDF 应用,全部处理在浏览器本地完成,无需上传。
二、核心功能
| 功能 | 说明 |
|---|---|
| 多图片合并 | 支持一次性上传多张 JPG、PNG、WebP、GIF、BMP 图片,合并为一个 PDF |
| 拖拽调整顺序 | 上传后可通过拖拽调整图片在列表中的位置,合并时按最终顺序生成页面 |
| 页面尺寸自定义 | 支持自动适应图片、A4、Letter 三种页面尺寸 |
| 页边距可选 | 支持无边距、小(20pt)、中(40pt)、大(60pt)四种边距 |
| 按比例缩放居中 | 图片尺寸不一致时自动按比例缩放并居中,避免变形 |
| 生成进度提示 | 处理多张图片时显示进度条与当前处理张数 |
| 纯前端本地处理 | 所有处理在浏览器内存完成,图片不上传服务器,支持离线运行 |
| 免登录免费无水印 | 打开页面即用,无需注册,不加水印,不限制转换次数 |
| 深色/浅色主题 | CSS 变量适配深色模式 |
三、技术实现
3.1 整体架构
该工具是一个纯前端单页面应用,未引入 Vue/React 等前端框架,全部逻辑使用原生 JavaScript 实现:
浏览器端(纯原生 JavaScript)
├── 输入层:图片文件选择/拖拽、页面尺寸、页边距
├── 处理层:文件去重、拖拽排序、图片嵌入 PDF、页面布局计算
├── 生成层:pdf-lib 创建 PDF 文档并嵌入图片,FileSaver.js 下载
└── 渲染层:文件列表、进度条、结果面板、下载按钮
3.2 依赖库
页面通过 CDN 引入两个关键库:
<script src="https://unpkg.com/pdf-lib@1.17.1/dist/pdf-lib.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/FileSaver.js/2.0.5/FileSaver.min.js"></script>
- pdf-lib@1.17.1:纯 JavaScript PDF 库,用于创建 PDF 文档、嵌入图片、添加页面、保存输出;
- FileSaver.js@2.0.5:用于将生成的 Blob 保存为 PDF 文件,非 HTTPS 环境下降级为
a.download原生下载。
3.3 图片上传与去重
支持点击选择和拖拽上传,接受 image/png, image/jpeg, image/webp, image/gif, image/bmp 类型。
为避免重复文件干扰顺序,按文件名 + 文件大小 + 修改时间构建唯一键进行去重:
function handleFiles(fileListObj) {
const existingKeys = new Set(files.map(f => `${f.name}_${f.size}_${f.lastModified}`));
for (let file of fileListObj) {
if (!isImageFile(file)) continue;
const key = `${file.name}_${file.size}_${file.lastModified}`;
if (existingKeys.has(key)) continue;
existingKeys.add(key);
files.push(file);
}
renderList();
}
isImageFile 优先判断 MIME 类型,兜底通过扩展名识别,兼容部分浏览器未正确设置 file.type 的情况。
3.4 拖拽排序
文件列表项设置 draggable="true",利用 HTML5 拖拽 API 实现顺序调整:
dragstart:记录当前项索引,设置拖拽效果为move;dragover:调用e.preventDefault()允许放置;drop:读取dataTransfer.getData('text/plain')获取源索引,将项从原位置移除并插入到目标位置,重新渲染列表。
为避免子元素触发 dragleave 导致高亮闪烁,上传区使用拖拽计数器控制 dragover 类的添加与移除。
3.5 PDF 生成(核心逻辑)
使用 pdf-lib 创建 PDF 文档,按顺序遍历图片文件,为每张图片添加一页:
const pageSizeMode = $('page-size').value; // 'auto' | 'a4' | 'letter'
const margin = parseInt($('page-margin').value, 10); // 0 / 20 / 40 / 60
const SIZES = {
a4: { w: 595.28, h: 841.89 },
letter: { w: 612, h: 792 }
};
const pdfDoc = await PDFLib.PDFDocument.create();
for (let i = 0; i < files.length; i++) {
const file = files[i];
const arrayBuffer = await file.arrayBuffer();
let image;
if (file.type === 'image/png') {
image = await pdfDoc.embedPng(arrayBuffer);
} else if (file.type === 'image/jpeg' || file.type === 'image/jpg') {
image = await pdfDoc.embedJpg(arrayBuffer);
} else {
// WebP / GIF / BMP 等:通过 Canvas 转为 JPEG 再嵌入
const img = new Image();
const url = URL.createObjectURL(file);
img.src = url;
await new Promise((resolve, reject) => {
img.onload = resolve;
img.onerror = () => reject(new Error('图片加载失败:' + file.name));
setTimeout(() => reject(new Error('图片加载超时:' + file.name)), 15000);
});
const canvas = document.createElement('canvas');
canvas.width = img.width;
canvas.height = img.height;
const ctx = canvas.getContext('2d');
ctx.fillStyle = '#ffffff'; // 填充白底,防止透明底变黑
ctx.fillRect(0, 0, canvas.width, canvas.height);
ctx.drawImage(img, 0, 0);
const jpgUrl = canvas.toDataURL('image/jpeg', 0.95);
URL.revokeObjectURL(url);
const jpgBuffer = await (await fetch(jpgUrl)).arrayBuffer();
image = await pdfDoc.embedJpg(jpgBuffer);
}
const imgW = image.width;
const imgH = image.height;
// 确定页面尺寸
let pageW, pageH;
if (pageSizeMode === 'auto') {
pageW = imgW + margin * 2;
pageH = imgH + margin * 2;
} else {
pageW = SIZES[pageSizeMode].w;
pageH = SIZES[pageSizeMode].h;
}
const page = pdfDoc.addPage([pageW, pageH]);
// 按比例缩放并居中
const availW = pageW - margin * 2;
const availH = pageH - margin * 2;
const ratio = Math.min(availW / imgW, availH / imgH);
const drawW = imgW * ratio;
const drawH = imgH * ratio;
const x = margin + (availW - drawW) / 2;
const y = margin + (availH - drawH) / 2;
page.drawImage(image, { x, y, width: drawW, height: drawH });
// 更新进度
updateProgress(Math.round(((i + 1) / files.length) * 100), `正在处理第 ${i + 1} / ${files.length} 张图片...`);
}
const pdfBytes = await pdfDoc.save();
const blob = new Blob([pdfBytes], { type: 'application/pdf' });
关键点:
- 格式嵌入:PNG 直接用
embedPng,JPEG 直接用embedJpg;WebP/GIF/BMP 等 pdf-lib 不直接支持的格式,先通过Canvas绘制并填充白色背景(避免透明 PNG 在 PDF 中出现黑底),再toDataURL('image/jpeg', 0.95)转为 JPEG 嵌入; - 页面尺寸:
auto模式按图片原始尺寸 + 边距生成页面;A4(595.28×841.89 pt)和Letter(612×792 pt)为固定标准尺寸; - 比例缩放居中:
ratio = min(availW/imgW, availH/imgH),保持原图比例,居中放置,避免变形; - 超时与错误处理:图片加载设置 15 秒超时,
onerror捕捉损坏文件,try-catch包裹整个生成流程,失败时弹出错误并恢复按钮状态; - 进度反馈:每处理一张图片更新一次进度条,用户可直观了解生成状态。
3.6 文件下载
生成的 PDF 转为 Blob 后下载:
if (typeof saveAs === 'undefined') {
// 降级方案:a 标签原生下载
const url = URL.createObjectURL(downloadBlob);
const a = document.createElement('a');
a.href = url;
a.download = 'images_merged.pdf';
document.body.appendChild(a);
a.click();
document.body.removeChild(a);
setTimeout(() => URL.revokeObjectURL(url), 1000);
} else {
saveAs(downloadBlob, 'images_merged.pdf');
}
优先使用 FileSaver.js 的 saveAs;若库未加载(如非 HTTPS 或网络异常),降级为创建隐藏 a 标签触发浏览器原生下载,并及时 revokeObjectURL 释放内存。
3.7 前端实现要点
- 防抖与状态锁:生成过程中禁用“生成 PDF”按钮并关闭上传区交互,防止重复提交;
- 结果面板:生成成功后显示合并张数与文件大小(MB),提供下载按钮;
- 内存管理:
URL.revokeObjectURL及时释放图片与 PDF Blob 的对象 URL; - 深色模式:全站使用 CSS 变量定义配色,深色模式下卡片背景、边框、文字颜色自动适配;
- 依赖兜底:生成前检测
typeof PDFLib === 'undefined',CDN 加载失败时提示用户检查网络并刷新。
所有输入、绘制与 PDF 生成均在浏览器本地完成,图片内容不上传任何服务器。
四、关键技术挑战与解决方案
| 挑战 | 解决方案 |
|---|---|
| pdf-lib 不支持 WebP/GIF/BMP | 通过 Canvas 绘制并填充白底,toDataURL('image/jpeg') 转为 JPEG 再嵌入 PDF |
| 透明背景图片在 PDF 中可能显示为黑底 | Canvas 绘制前先 fillRect 白色背景,再绘制图像 |
| 超大图片导致 Canvas 内存溢出 | toDataURL 包裹 try-catch,失败时提示图片过大 |
| 图片加载挂起导致页面卡死 | img.onload/onerror 配合 15 秒 setTimeout 超时控制 |
| 拖拽排序时子元素导致高亮闪烁 | 上传区拖拽计数器,仅在计数归零时移除 dragover 类 |
非 HTTPS 环境 saveAs 不可用 | FileSaver.js 优先,失败后降级为 a.download 原生下载 |
| 重复文件干扰顺序 | 按 name_size_lastModified 构建唯一键去重 |
| 纯前端无后端依赖 | 所有处理封装在前端,浏览器即可离线运行 |
五、使用示例
场景:将 5 张发票图片合并为一份 A4 PDF,供报销使用
- 打开
https://toolion.cn/image-to-pdf/; - 点击上传区或拖拽 5 张 JPG/PNG 发票图片进去;
- 通过拖拽调整图片顺序,确保发票按日期排列;
- 页面尺寸选择“A4 尺寸”,页边距选择“中边距 (40pt)”;
- 点击“生成 PDF 文件”,等待进度条完成;
- 点击“下载 PDF 文件”,保存为
images_merged.pdf。
注意事项:
- 图片尺寸差异较大时,建议选择“自动适应图片”页面尺寸,每张图按原始比例生成页面,避免强制缩放变形;
- 需要打印的文档建议选择 A4 尺寸与中/大边距,方便装订;
- 一次性合并几十张甚至上百张高清图片时,生成可能需要数秒,请耐心等待进度完成;
- 涉及身份证、银行卡、发票等敏感图片,建议使用本地处理工具,避免上传到第三方服务器。
六、免责声明
本文仅提供技术实现分享,相关工具仅供学习与日常便利使用,不构成任何商业建议。生成的 PDF 质量受图片分辨率、页面尺寸与边距设置影响,重要文档建议生成后检查一遍。本工具在浏览器本地内存中处理图片,图片不会上传到服务器,页面关闭后即从内存释放。
七、总结
本文介绍了一种纯前端实现的图片批量转 PDF 方案。核心设计思路:
- 多图合并:支持一次性上传多张图片,按顺序合并为一个 PDF 文件;
- pdf-lib 生成:PNG/JPEG 直接嵌入,WebP/GIF/BMP 经 Canvas 转为 JPEG 再嵌入,保持图片质量;
- 页面布局:支持 A4/Letter/自动页面尺寸与多级边距,图片按比例缩放居中,避免变形;
- 拖拽排序:HTML5 拖拽 API 实现图片顺序自定义,合并前灵活调整;
- 隐私优先:全部处理在浏览器本地完成,图片不上传服务器,无需登录,无水印;
- 健壮性:依赖加载检测、图片加载超时、Canvas 内存兜底、try-catch 错误处理、Blob 内存释放。
该方案适合需要轻量级、纯前端图片转 PDF 的场景,可作为前端文档处理类工具页面的技术参考。
#图片转PDF #多图合并PDF #pdf-lib #FileSaver.js #纯前端 #JavaScript #Canvas #本地处理 #隐私安全 #办公工具 #PDF生成 #图片处理 #工具开发