二维码生成时容错等级与数据密度的平衡

二维码的容错等级决定了多少编码空间要让给纠错信息，也会影响最终版本、模块密度和可承受的局部损坏。L、M、Q、H 并不是“能遮住 7%、15%、25%、30% 图像”的面积开关；选择等级时，应把数据长度、打印尺寸和真实扫码测试放在一起判断。

四级容错如何分配二维码码字空间

QR Code 使用 Reed–Solomon 纠错。它把原始数据之外的部分空间编码成纠错码字，扫码器可利用这些冗余恢复一部分受损数据。常用定义中，L、M、Q、H 四级分别约可恢复 7%、15%、25%、30% 的码字损坏。

• L：约 7%，适合干净屏幕或质量稳定的印刷品。
• M：约 15%，通常是屏幕展示和普通印刷的起始测试档位。
• Q：约 25%，适合可能有轻微污损、折损或需要放置小图标的场景。
• H：约 30%，面向户外标签、磨损风险较高的应用，但不代表无条件更可靠。

这些百分比描述的是可恢复的编码码字比例，不是二维码图像可随意遮挡的面积。遮住一个数据区域，影响可能有限；遮住定位图形或格式信息，即使面积较小，也可能让扫码器无法完成定位和解码。

纠错码会占用符号容量。容错等级越高，留给原始数据的码字越少；如果数据长度不变，生成器可能选择更大的版本。版本变大后，二维码的模块数量增加，若物理尺寸不变，每个模块会更小，识别难度反而可能上升。

“字符数”也不能直接等同于“码字容量”。数字模式、英数字模式、字节模式和日文模式的编码效率不同：一串纯数字通常比同长度的通用 UTF-8 文本占用更少空间。比较容量时，必须同时记录字符类型、编码模式和纠错等级。

版本尺寸如何改变字符容量与扫码难度

QR Code 的版本范围是 1～40。版本 1 的符号尺寸为 21×21 个模块，版本每增加 1，边长增加 4 个模块，因此版本 40 为 177×177 个模块。这里的模块是二维码中最小的黑白方块。

版本越高，理论容量越大，但同一张纸上的物理尺寸不变时，模块会变小。例如，一个版本 10 的二维码如果印成 50 毫米宽，边长模块数是 57；版本 20 则是 97 个模块。在相同宽度下，后者的单模块尺寸更小，对打印分辨率、对比度和镜头清晰度要求更高。

可以用固定案例观察容错等级的影响：取同一段 100 个 ASCII 字符，指定相同的字节编码，分别设置 L、M、Q、H，然后记录生成器采用的版本号和模块边长。具体结果必须以所选工具及其版本的实际输出为准，因为不同实现对字符编码、版本选择、掩模和边距的默认处理可能不同；不能直接套用别人的版本号。

二维码生成工具通常会自动选择能够容纳数据的最小版本，但自动结果取决于以下设置：

• 纠错等级和字符编码方式；
• 固定版本还是自动版本；
• 静区宽度，即二维码外侧保留的空白边界；
• 掩模方案，以及是否启用结构化追加；
• 输出格式、缩放算法和最终物理尺寸。

ISO/IEC 18004:2015《Information technology — Automatic identification and data capture techniques — QR Code bar code symbology specification》是 QR Code 的标准来源。实际工具可能支持该标准的不同修订或扩展，因此 Python 的 qrcode 库、ZXing、Nayuki QR Code generator 的默认参数和版本选择结果不能假定完全一致。

遮挡测试应怎样判断二维码还能扫描

二维码并非所有模块都负责存储普通数据。定位图形帮助扫码器确定三个角的位置；校准图形用于较大版本的几何校正；时序图形帮助确定模块网格；格式信息则记录纠错等级和掩模等关键参数。遮挡位置因此比单纯遮挡面积更关键。

1. 生成一组固定版本、固定纠错等级和固定物理尺寸的样本。
2. 固定扫描距离、光线和拍摄角度，先测试无遮挡样本。
3. 分别在中心、边缘、定位图形附近覆盖相同尺寸的不透明小块。
4. 使用至少两款扫码器或不同品牌手机重复扫描，每个位置测试多次。
5. 记录首次失败的位置、遮挡尺寸、设备型号、距离和环境，而不是只记录“能否扫出”。

实际可读性还受打印分辨率、黑白对比度、反光、透视变形、污损形状和扫码器实现影响。L/M/Q/H 不能直接换算成固定的安全遮挡面积，二维码生成器界面显示“生成成功”，也不等于目标设备一定能稳定识别。

用二维码生成工具选择合适容错等级

1. 先统计数据长度和字符类型，确认是数字、英数字还是 UTF-8 字节数据。
2. 确定二维码的目标物理尺寸、最小模块尺寸和扫描距离。
3. 根据环境从 M 级开始测试；干净屏幕或稳定印刷可比较 L 与 M。
4. 需要放置小图标、可能出现轻微污损或折损时测试 Q。
5. 户外标签、物流贴纸等磨损风险较高的场景再考虑 H，并重新确认物理尺寸是否足够。
6. 记录纠错等级、版本或自动版本、字符编码、静区宽度、输出格式和缩放方式。

实际生成时，可使用站内二维码生成工具快速制作对比样本，也可以用 Python 的 qrcode 库批量测试。优先导出 SVG 或无损 PNG；JPEG 压缩产生的边缘伪影可能改变模块形状，尤其不适合小尺寸二维码。若使用库或在线工具，应记录具体版本，因为默认静区、掩模和版本策略取决于实现。

最容易误解的结论

• 误解：H 级能容忍约 30% 损坏，所以二维码可以遮住 30% 面积。
  事实：30%针对编码后的码字，不等于图像面积；遮挡关键功能图形时，小面积也可能导致失败。
• 误解：容错等级越高，扫码距离一定越远。
  事实：高等级会减少数据空间，可能推高版本或缩小模块；距离取决于尺寸、光学质量、对比度和设备。
• 误解：同样的字符数一定需要同样大小的二维码。
  事实：数字、英数字、字节和日文模式的编码效率不同，字符编码与工具实现会改变版本结果。

选择原则可以压缩成一句操作标准：在目标尺寸和真实设备测试通过的前提下，使用尽可能低的容错等级。这样既保留足够的抗损坏能力，也避免为了追求 H 级而付出更高模块密度和更低识别余量的代价。