OmniKit
OMNIKIT · 实用参考

二维码扫不出来?用六张样本排查原因

下载六张二维码图片,对照真实解码记录,排查裁切、像素不足与粘贴问题。

先用清晰样本判断问题在哪里

先试扫清晰原图。如果样本能识别而自己的图片不能,优先检查分辨率、是否被裁切和周围留白。如果样本也失败,请尝试重新加载或更新浏览器,并通过联系页提供浏览器版本与复现步骤。识别出的链接不会自动打开;本工具不检查目标网站是否安全。

测量方法与使用授权

2026-09-09,在 Node Canvas 中用网站实际发布的 decodeQr 模块读取这六张 PNG。清晰、反色、旋转和虚构名片的输出与原文一致;24 像素和裁切样本未识别。这是参考环境结果,不是识别成功率或手机相机兼容性测试。所有图片均小于扫描器的 1800 像素缩放边界。

前五张原始内容为 https://omni-kit.com/qr/scanner;名片为虚构联系人。下载输入与测量记录 · CC0 素材授权说明。素材可复用,引用本指南能帮助读者复现,但不是使用条件。

按失败原因处理

  1. 像素不足:取得原始 PNG 或清晰导出图。放大 24 像素图片不能恢复丢失的细节。
  2. 裁切:保留完整二维码和留白。可用图片裁剪去掉无关区域,但不要裁进二维码。
  3. 大截图里的小码:扫描器会把最长边缩到 1800 像素。先裁取二维码所在区域并保留边框,避免小码随整图缩小。
  4. 反光、模糊或倾斜:正对重新拍摄并改善光线。旋转样本只验证 90 度旋转,未验证任意倾斜和反光。
  5. 粘贴失败:允许粘贴按钮读取图片剪贴板,或直接选择、拖入 PNG、JPG、WebP,最大 20 MB。

选择适合的下一步

本页识别单张图片中的二维码,不是批量多码提取器。普通图片文字请用OCR;从清单制作多个码请用批量生成;联系人请用vCard 生成器。

继续阅读

查看其他案例与指南 →