二维码解码

批量识别图片中的二维码内容

二维码解码识别：从图像中提取隐藏的信息

基于 jsQR 引擎的批量二维码识别工具，支持同时处理多张图片，一键导出识别结果到 Excel。

二维码识别的技术原理

二维码（QR Code）的「解码」过程远比看起来复杂。当一张包含 QR 码的图片被提交给识别引擎时，后台发生了一系列精密的操作：

  1. 图像预处理：将原始图片转换为灰度图，然后进行二值化（黑白化）处理。这一步的目的是消除颜色、光照不均等因素的干扰，让二维码的黑白模块清晰可辨。
  2. 定位图案检测：QR 码标准要求三个角落必须存在「回」字形的定位图案（Position Detection Pattern）。识别引擎首先在图像中搜索这三个特征图形，从而确定 QR 码的位置、旋转角度和基本尺寸。
  3. 透视校正：如果拍摄角度不是正对的（存在倾斜、透视变形），引擎会根据三个定位点的坐标计算变换矩阵，将倾斜的 QR 码「拉正」为标准的正方形。
  4. 数据提取与纠错：按照 QR 码的编码规则逐行读取黑白模块数据，并通过 Reed-Solomon 纠错算法恢复可能损坏的数据位。QR 码内置了最高 30% 的容错能力——即使部分区域被遮挡或污损，仍能完整还原内容。
  5. 解码输出：将二进制数据根据模式指示器（数字/字母/字节/汉字/Kanji）解码为最终的可读文本。

什么时候需要批量解码？

单张二维码用手机扫一扫就能搞定，但以下场景中批量识别是更高效的方案：

  • 资产盘点：仓库中的每个货架/商品都贴有 QR 码标签，需要一次性记录所有物品信息。用手机逐个扫码耗时且容易遗漏。
  • 票据/凭证归档：一批电子票、兑换码、优惠券以图片形式保存，需要将其中嵌入的信息提取到表格中。
  • 设计稿审查：设计师交付了一组包含不同 QR 码的素材图，需要验证每个码的内容是否正确对应。
  • 竞品分析：收集竞争对手的一批宣传物料截图，批量提取其中的链接和文本信息用于分析。
  • 历史档案数字化：旧文档中的二维码图片需要批量转写为可检索的文本数据。

常见问题

支持哪些类型的二维码？只能识别 QR Code 吗？

本工具基于 jsQR 库实现，专门针对 ISO/IEC 18004 标准的 QR Code（包括 Model 2 的所有版本 1-40）。对于常见的微信收款码、支付宝收款码、网址链接码、文本码等标准 QR 码，识别率非常高。不支持的是其他二维条码格式，如 Data Matrix、PDF417、Aztec Code 等。如果遇到这些格式，建议使用专业的条码识别 SDK（如 ZXing 的多格式版本）。

识别失败或结果显示「未识别到二维码」怎么办？

常见原因及解决方案：（1）图片模糊——拍摄时对焦不准或压缩过度导致细节丢失，尝试使用更高清的原图；（2）对比度不足——QR 码与背景色差太小（如灰色背景上的深灰码），可以用图片编辑工具增加对比度后重试；（3）遮挡过多——超过 30% 区域被遮挡超出了纠错能力上限；（4）不是标准 QR 码——某些艺术化的装饰性二维码可能不符合标准规范；（5）图片中有多个 QR 码——当前版本只返回第一个识别到的结果，如果图中包含多个码，可以尝试裁剪出单个码的区域单独识别。

一次最多可以上传多少张图片？

没有严格的数量限制，但建议单次不超过 50 张。每张图片都需要加载到内存中进行图像处理运算，大量高分辨率图片同时处理可能导致浏览器内存占用过高。如果确实需要处理上百张图片，建议分批进行（如每次 20-30 张），然后将多次导出的 Excel 合并即可。另外，单张图片大小限制为 10MB，超大图片请先压缩。

导出的 Excel 包含哪些信息？

Excel 文件包含三列：序号（图片的处理顺序）、识别结果（解码出的文本内容，如果识别失败则显示错误原因）、状态（成功/失败）。文件采用 .xlsx 格式，可以用 Excel、WPS、Google Sheets 或任何兼容软件打开。文件名遵循统一命名规则：二维码识别结果_主机名_时间戳.xlsx。

识别出的内容是安全的吗？会不会被服务器记录？

完全安全。本工具的所有识别操作都在你的浏览器本地完成，jsQR 库作为 JavaScript 脚本直接在你的设备上运行。图片数据和识别结果都不会传输到任何远程服务器。这意味着你处理的敏感内容（如内部系统链接、私密信息等）只有你自己能看到。这也是纯前端工具相比在线 API 服务最大的隐私优势——你的数据永远不会离开你的设备。

和手机扫码相比，准确率如何？

对于清晰的、正对拍摄的 QR 码图片，本工具的识别率可以达到 99% 以上，与手机扫码效果相当甚至更好（因为不受环境光干扰）。但在处理倾斜、模糊、低对比度的图片时，手机的专用扫描模组（通常有多帧合成、自动对焦、曝光优化等硬件级辅助）会有优势。简单来说：理想条件下的静态图片适合用本工具；复杂条件下的实时扫描手机摄像头更强。两者互补而非替代关系。