二维码解码器 - 在线识别解析图片截图中的二维码

二维码的解码过程本质上是"图案 → 二进制数据 → 可读文本"的反向转换。扫码引擎首先在图像中定位三个角落的定位图案（Finder Pattern）——这三个独特的"回"形方块能让算法快速识别二维码的位置、方向和倾斜角度。

在确定位置后，算法会沿着时序图案（Timing Pattern）读取每一行每一列的模块，将黑色方块视为 1、白色方块视为 0，从而得到一个二进制矩阵。接着通过Reed-Solomon 纠错算法验证并纠正读取错误，最后根据数据编码规则（数字、字母数字、字节、日文汉字）将二进制数据还原为原始文本。

本工具在浏览器中使用 jsQR 库进行纯前端解码，支持从任意包含二维码的图像中提取内容。您也可以配合我们的二维码生成工具生成自己的二维码后进行反向验证。

二维码识别失败通常与图像质量或图案完整性有关。以下是实践中最常见的问题：

• 图像模糊或分辨率过低：如果每个方块模块在图像中少于 2-3 个像素，算法就无法可靠地区分黑白。建议使用原始分辨率的截图，避免通过相机二次拍摄屏幕。
• 污损、遮挡或撕裂：虽然 Reed-Solomon 纠错能容忍约 15%-30% 的模块损坏，但如果定位角（三个回形图案）被遮挡，算法将无法启动解码流程。
• 颜色对比度不足：彩色二维码或低对比度配色（如浅灰底 + 浅蓝块）可能导致二值化失败。标准的黑底白字/白底黑字识别率最高。
• 图像倾斜或扭曲严重：相机拍摄非正面视角时会产生透视变形，此时建议重新以正面、水平方向拍摄。
• 反光、阴影或光线不均：拍摄屏幕时的屏幕反光、打印件上的强光源反射都会使局部模块的颜色被误判。

遇到解码失败时，可尝试以下操作：重新上传更清晰的原图、裁切出仅包含二维码的区域、在光线均匀的环境下重新拍摄。本工具支持点击上传、拖拽文件和Ctrl+V 粘贴截图，多种方式可以灵活组合使用。

本工具的二维码解码过程完全在浏览器本地完成，上传的图片不会被发送到任何远程服务器。具体而言：你选择的图片文件仅通过浏览器的 FileReader API 读取，解码算法在 JavaScript 中运行，识别结果直接写入页面文本区域。

这意味着：即使断开互联网连接，工具仍然可以正常使用；关闭浏览器标签后，所有图像和解码内容立即从内存中清除；不存在任何云端缓存或日志记录。

对于包含敏感信息（如个人身份、访问凭证、内部链接）的二维码，我们仍建议在完成解码后关闭标签页，以避免浏览器历史记录或恢复会话时意外泄露。如需同时生成二维码，可以配合我们的二维码生成工具使用，同样是纯前端运行。