快递面单信息校验
分拣员扫描面单上的一维码后，系统读取的运单号与实际包裹上的手写单号不一致，导致包裹错发。使用本工具将运单号、目的地分拣中心代码、客户电话三项信息合并生成 PDF417 码，打印在面单副联。分拣机读取时自动比对三项数据，任何一项不匹配则触发报警，拦截错误包裹。纠错等级设为 5 级，即使面单被胶带覆盖或褶皱，扫码成功率仍保持在 98% 以上。
PDF417 常用于承载大容量数据（最多约 1850 个字符 / 1110 字节）。中文等会自动按 UTF-8 字节编码。
编 码Error Correction & Columns
外 观Modules & Quiet Zone
模块宽2.5px
行高3×
静区2
建议用纯黑前景 + 纯白背景以保证扫码率；PDF417 是宽矩形堆叠码，留足静区与高度更易被扫读。
输入内容即出码
就绪 · 输入内容实时出码并本机回扫自检
PDF417 用在哪大容量 · 可纠错 · 标准化
身份证件 / 驾照
多国驾照、身份卡背面以 PDF417 存姓名、证号、签发信息等结构化数据，扫一次即读全。
登机牌 BCBP
航空业 BCBP 标准用 PDF417 承载航班、座位、值机等信息，登机口闸机快速核验。
物流面单
快递/邮政面单用其装运单号、地址段、分拣码，破损后凭纠错仍可恢复读取。
票证 / 文档
邮票、税单、表单回执等需在小面积内塞下较多文本时的常见选择，胜过一维码容量。
第一节
关于本工具
About物流单上的 PDF417 码，扫出来若是一串乱码，整批货的流转就卡住了。这个工具把 PDF417 符号解码成明文，专治那些手持终端读不出、或后台日志里截下来的模糊图像。拖入图片或粘贴 Base64，它直接在浏览器里跑解码算法，图像不离开本地。对证件号、运单号这类紧凑编码尤其准——前提是码图清晰、没有严重畸变或污损。
使用场景
仓库托盘标签更新
仓库管理员每天需要为 200 个托盘更换标签，原标签只印了托盘号，无法承载批次号、入库日期、质检状态。用本工具将托盘号、批次号、入库日期、质检结果编码为 PDF417 码，一个码替代三张贴纸。叉车司机扫码后直接看到该托盘所有信息，无需再翻纸质台账。码的宽高比可调至 3:1，适配窄条标签打印机，不占用托盘贴标区域。
物流中转站分拣纠错
中转站分拣员在 30 秒内需判断 10 个包裹的去向，面单上的地址模糊或被磨损，导致分拣错误率高达 5%。将收件地址、邮编、下一站中转代码编入 PDF417 码，分拣员用扫描枪读取后，系统自动亮灯指示对应格口。码的纠错等级设为 4 级，即使面单被雨水打湿或部分撕毁，仍能正确解码。使用后分拣错误率从 5% 降至 0.3%。
证件信息离线核验
边防检查站网络中断，无法联网查询旅客证件真伪。检查员使用本工具将旅客护照号码、签证类型、有效期、签发机关编码生成 PDF417 码，打印在入境章旁。后续检查员扫描该码，与旅客提供的纸质证件信息进行比对，码内数据与证件信息一致则放行。码的纠错等级设为 6 级，即使纸张折叠或沾水，仍能读取完整信息，确保离线核验的可靠性。
第二节
使用指南
Getting Started使用步骤
- 1在文本框中输入待编码的文本（如物流单号），右侧实时预览生成的 PDF417 条码图形
- 2点击「纠错等级」下拉菜单，选择 L0–L8 级别（级别越高，条码尺寸越大但抗污损能力越强）
- 3勾选「显示字符数」后，条码下方自动标注当前文本长度，便于核对输入是否完整
- 4点击条码图形旁的「下载」按钮，以 PNG 格式保存当前条码到本地
输入输出示例
| 输入 | 输出 | 说明 |
|---|---|---|
| Hello, PDF417! | （编码为 PDF417 条码图像，数据内容为 'Hello, PDF417!'） | 常规：基础文本编码，验证工具能否正确生成条码并解码回原字符串。 |
| https://www.quanbao5.com/erweima/pdf417 | （编码为 PDF417 条码图像，数据内容为完整 URL） | 常规：URL 是常见应用场景（如物流面单、证件信息），验证长文本支持。 |
| 1234567890123456789012345678901234567890 | （编码为 PDF417 条码图像，数据内容为 40 位数字串） | 边界：长数字串，验证工具对连续数字的编码效率及条码尺寸控制。 |
| （无输出或提示：输入内容为空） | 边界：空输入处理，验证工具是否给出明确提示而非生成空条码。 | |
| 中文测试：物流单号 ABC123 | （编码为 PDF417 条码图像，数据内容为 '中文测试：物流单号 ABC123'） | 易错：中文字符编码，PDF417 支持 Unicode，但部分工具可能默认 ASCII 导致乱码。 |
| A | （编码为 PDF417 条码图像，数据内容为 'A'） | 边界：最小输入（单个字符），验证工具能否处理极短数据。 |
| 特殊符号：!@#$%^&*()_+-=[]{}|;:',.<>?/~` | （编码为 PDF417 条码图像，数据内容为全部特殊符号） | 易错：特殊符号编码，PDF417 的字符集限制（如不支持某些控制字符），验证工具是否报错或转义。 |
常见错误对照
1.数据过长导致截断
✗ 错误
输入 3000 个字符的文本✓ 修复
输入 1000 个字符以内的文本PDF417 码容量有限（约 1KB 二进制或 1850 个字母），超出后工具会截断或生成失败，物流面单通常限制在 500 字符内。
2.混用中文与英文符号导致解码失败
✗ 错误
输入“张三，地址：北京”✓ 修复
输入“张三,地址:北京”PDF417 码默认使用 ASCII 编码，中文逗号、冒号等全角符号会打乱字节对齐，部分扫描器无法正确解析。
3.未按行业规范组织字段顺序
✗ 错误
输入“北京 张三 100101”✓ 修复
输入“张三 北京 100101”物流面单通常要求姓名→地址→邮编的顺序，乱序会导致自动分拣系统读取错误。
4.包含不可见控制字符
✗ 错误
从 Word 复制含制表符的文本✓ 修复
手动输入或用纯文本编辑器粘贴制表符、换行符等控制字符在 PDF417 码中会被编码，但多数扫描器会将其视为数据的一部分，导致字符串拼接异常。
5.忽略纠错等级与数据长度的匹配
✗ 错误
选择最高纠错等级后输入 1500 个字符✓ 修复
选择中等纠错等级（Level 3）后输入 800 个字符纠错等级越高，数据容量越小。Level 8 下最大容量仅约 900 字母，超出后工具自动降级纠错或报错。
6.在证件场景中遗漏校验位
✗ 错误
输入身份证号“110101199001011234”✓ 修复
输入身份证号“11010119900101123X”PDF417 码本身不校验内容合法性，但证件系统依赖末位校验码，漏写会导致系统拒读。
第三节
工作原理
How It Works核心公式
PDF417 码数据容量 = 每行码字数 × 行数 × 每个码字承载数据位数 ÷ 8
变量说明
每行码字数每行包含的码字数量，1–30行数码的总行数，3–90每个码字承载数据位数纠错等级不同，9–10 位
示例
物流面单使用 PDF417 码，每行 10 个码字、共 20 行、纠错等级 2（每个码字 10 位数据）：容量 = 10 × 20 × 10 ÷ 8 = 2000 ÷ 8 = 250 字节，可存储约 250 个 ASCII 字符的收件地址与运单号。
用户输入
本地处理
输出结果
输出格式
第五节
常见问题
Q & A问我有个物流单上的 PDF417 码，手机扫不出来怎么办？＋
答
PDF417 是层叠式二维条码，常见于快递面单和证件，普通手机相机或微信扫码通常不支持识别，需要专用解码工具。本工具纯浏览器端解码，把条码图片上传或拖入即可，不用安装软件。如果扫码后只显示一串数字或乱码，说明已成功解码内容，只是内容本身是编码格式（如 Base64），粘贴到文本编辑器查看即可。
问PDF417 和 QR 码到底有什么区别？为什么物流不用 QR？＋
答
PDF417 是堆叠式条码，信息密度高，能在一行内塞下几百个字符，适合存储地址、姓名、电话等结构化文本；QR 码是矩阵式，更适合短链接或小数据。物流面单需要打印后快速扫描，PDF417 对打印精度要求低、抗污损能力强，且支持纠错（即使部分破损仍可解码），因此快递行业普遍采用它而非 QR 码。
问生成的 PDF417 码传到国外物流系统，对方扫不出来，是不是编码格式不对？＋
答
大概率不是格式问题，而是字符集或编码模式。PDF417 支持文本、字节、数字三种压缩模式，如果内容含中文或特殊符号，工具默认用文本模式 + UTF-8 编码，但某些老系统只认 ISO-8859-1 或 GBK。建议生成前确认对方系统的字符集要求；本工具生成时允许手动切换编码模式（文本/字节/数字），若对方系统老旧，可尝试用字节模式重新生成。
问为什么我把 PDF417 码图片放大后，扫描反而扫不出来了？＋
答
PDF417 解码依赖模块的宽高比和行间距，图片被放大后，如果缩放比例不是整数倍，模块边缘会模糊或出现锯齿，导致解码器无法定位起始符和结束符。建议保持原图分辨率，或使用工具内置的「放大输出」功能（按比例整数倍缩放），不要用图片编辑器随意拉伸。如果已经模糊，可以尝试把图片缩小回原始尺寸再扫。
问这个工具处理 PDF417 码时，图片会不会上传到服务器？＋
答
不会。本工具完全在浏览器本地运行（纯前端实现），图片上传后仅经过内存中的解码算法处理，解码完成后图片数据即被释放，不发送任何数据到后端服务器。适合处理包含个人隐私的证件或物流单。如果担心内存残留，解码后刷新页面即可清除所有缓存。
问生成的 PDF417 码打印出来贴纸箱上，快递员扫不出来，是不是尺寸不对？＋
答
PDF417 对打印尺寸有最低要求：模块宽度（单个小方块）建议不小于 0.25mm，整码宽度不宜小于 2cm。如果打印得太小，扫描枪无法分辨行与行之间的间隙。建议生成时选择「高纠错级别」（至少 Level 3），打印前用尺子量一下码的实际宽度，确保不低于 2cm。另外，热敏纸打印时避免高温或潮湿环境，否则油墨扩散会导致条码糊掉。
问我复制了一段文本进去生成 PDF417，结果长度有限制吗？＋
答
PDF417 码本身没有严格的字符数上限，但受限于码的物理尺寸——文本越长，生成的码的行数越多，宽度也会增加。本工具默认限制输入字符数为 2000 个，超过时建议分段生成多个码。如果内容超过 500 字符，建议开启「紧凑模式」减少冗余空白，否则打印出来的码可能超过 A4 纸宽度。实际物流场景中，单个 PDF417 码通常容纳 200-500 字符。
问把 PDF417 码截图发微信再保存，解码失败，是不是工具的问题？＋
答
不是，问题出在微信的图片压缩。微信传输图片时默认会压缩分辨率，导致条码的模块细节丢失。建议通过文件传输助手发送原图（勾选「原图」选项），或直接用电脑浏览器打开本工具解码。如果只能手机操作，可以尝试用第三方文件传输工具（如 AirDrop 或网盘）保持原图质量。另外，本工具支持直接手机拍照上传，拍照时确保条码平铺、光线均匀。
隐私保证所有计算与处理均在你的浏览器本地完成，输入数据不会上传服务器，也不会保存或共享。