A. 痛点描述（Problem）#
二维码生成看起来很简单：输入 URL → 生成图片。但“能生成”不等于“能被稳定扫描”：
- 你加了 Logo 后突然扫不出来
- 你改了颜色后某些设备识别率极低
- 你把二维码缩得很小，用手机在光线差时几乎无法识别
- 你截图转发后变糊、变脏，识别率下降
二维码的本质是“高密度视觉编码”。想要稳定可扫，就必须尊重它的几个关键约束：纠错、尺寸、留白、对比度与遮挡面积。
工具入口：二维码生成与解析
👉 立即使用：二维码生成与解析
B. 核心原理（Deep Dive）——二维码为什么会“突然扫不出来”？#
1）纠错等级决定“能容忍多少损坏”#
常见纠错等级（越高越抗损坏，但容量越小、图案越密）：
- L：低（约 7%）
- M：中（约 15%）
- Q：高（约 25%）
- H：最高（约 30%）
工程经验：
- 普通 URL/文本：默认 M 通常够用
- 需要加 Logo、印刷、或可能被遮挡/反光：优先提高到 Q/H
2）模块大小决定“你能缩到多小”#
二维码由很多黑白小方块（模块）组成。
- 模块越小，单位面积信息越密
- 但摄像头成像、打印网点、屏幕像素都会让小模块变模糊
因此你需要按投放介质调整模块大小：
- 屏幕展示：模块大小可适中（避免过密）
- 打印物（海报/纸张）：模块应更大，并留足留白
3）留白（quiet zone）不是装饰，是识别边界#
二维码四周必须有足够的“安静区”（留白），否则识别器无法正确定位定位标记与边界。
很多“看起来差一点点”的扫不出，根因就是留白被裁掉了。
4）配色要保证对比度，别做“浅灰配浅蓝”#
二维码识别依赖对比度与边缘清晰度：
- 深色前景 + 浅色背景最稳
- 反色、渐变、低对比度会显著降低识别率
C. 操作指南（Step-by-step）——用小算云箱生成“可投放”的二维码#
第一步：输入内容（文本/URL）#
建议：
- URL 尽量用最终落地链接（避免中间跳转过多）
- 内容越长，二维码越密；如果需要承载很多信息，优先用短链或编码后再承载
第二步：选择纠错等级（决定“抗折腾能力”）#
推荐策略：
- 不加 Logo：M 或 Q
- 加 Logo：Q 或 H
- 需要打印/海报：Q 或 H，并搭配更大的模块
第三步：设置模块大小与留白#
经验值（仅供起步）：
- 模块大小：5 左右起步，根据预览识别率再调大
- 留白：不要设为 0；默认留白更稳
第四步：颜色配置（保证对比度）#
- 前景色尽量深（黑/深蓝/深灰）
- 背景色尽量浅（白/浅灰）
- 避免“背景接近前景”的配色
第五步：Logo 叠加（可选，但要克制）#
工具支持上传 Logo 或填写 Logo URL。注意两点：
- Logo 遮挡面积越大，对纠错等级要求越高
- Logo 最好留出白底或边框，让二维码模块边缘不被复杂纹理干扰
生成后建议你做一次“自测”：用不同手机/不同扫码 App 扫 3 次以上，再用于投放。
D. 常见问题（FAQ）#
1）为什么我加了 Logo 后扫码失败？#
通常是遮挡面积过大或纠错等级过低。解决思路：
- 把纠错等级提高到 Q/H
- 把模块大小调大（提高边缘清晰度）
- 缩小 Logo 或给 Logo 加白底边框
2）为什么截图转发后识别率下降？#
截图可能带来缩放、压缩与模糊。建议直接下载 PNG 原图并投放，避免二次压缩。
3）为什么配色一改就扫不出来？#
低对比度或复杂背景会让定位图案不清晰。保持“深前景 + 浅背景”是最稳的原则。
工具推荐#
- 二维码生成与解析（支持纠错等级/颜色/Logo）：立即使用：二维码生成与解析