二维码标签怎么做：内容、纠错等级与最小尺寸
二维码标签比一维条码好用：能装网址、能容忍破损、手机就能扫。但它也有自己的坑：内容一长码就密，密了模块就细，细到 0.25mm 以下热敏打印机就画不清；纠错等级选低了，标签沾点油污就废；批量打印时每条内容长短不一，同一张模板上的二维码会忽大忽小。本文按「放什么内容 → 选纠错等级 → 留静区 → 算最小尺寸 → 批量固定版本 → 验证扫描距离」的顺序讲一遍，每一步给具体数字，仓管、设备管理员、做溯源标签的质检员照着做就能出一张稳定可扫的二维码标签。
第一步：决定二维码里放什么
二维码里的内容决定了后面所有事。常见三种用法：一是网址，扫了跳转到溯源页、设备档案、说明书；二是纯文本编号，比如资产编号、批次号，配合自家系统的扫码枪录入；三是结构化文本，比如「设备号|保养日期|负责人」用分隔符拼起来。给人扫的用网址，给系统扫的用纯编号，不要混。
网址一定要短。二维码每多装一个字符，就可能升一个版本、多 4 行 4 列模块。一条带 UTM 参数的 120 字符网址要用到版本 7（45×45 模块），而 30 字符的短链接版本 2（25×25 模块）就够。同样印在 15mm 见方里，后者每个模块宽 0.45mm，前者只有 0.28mm。做标签前先把网址缩短：用自己域名的短链，或把参数放到服务端按编号查。
- 网址带 https://，不要省，省了部分手机不会当成链接
- 纯数字内容最省空间：数字模式下同样版本能装的位数是字母模式的 1.7 倍
- 不要在二维码里塞中文，中文按 UTF-8 每字 3 字节，容量消耗最大
第二步：按使用环境选纠错等级
二维码自带纠错：一部分模块被遮住、磨掉、印花了，仍然能读出完整内容。四个等级对应的可损坏面积是 L 约 7%、M 约 15%、Q 约 25%、H 约 30%。代价是等级越高码越密——同样的内容，H 比 L 多用将近一倍的模块。
怎么选：贴在干净包装盒上、扫一次就作废的用 L 或 M；仓库货架、周转箱、设备铭牌这类会磨损、沾油污、被胶带粘过的用 Q；户外设备、危废桶、需要几年不换的用 H。KuaiLabel 的默认值是 M，这也是行业最常用的选择；切到大师版后可以在二维码属性里改。
一个常见误区是「纠错高就能把二维码做小」。恰恰相反，纠错越高模块越多，同样边长里每个模块越细，反而更容易扫不出。纠错是为了抗破损，不是为了缩尺寸。
第三步：四周留够静区
静区是二维码四周的空白，规范要求每边至少 4 个模块宽。扫描软件靠三个角上的定位图案找到二维码，定位图案外面紧挨着黑色内容，就会误判边界。静区不是「留一点白就行」，是按模块数算的：模块 0.4mm 时每边要留 1.6mm。
KuaiLabel 的二维码元素默认按 4 个模块留静区，并且把静区算在元素框内——画布上看到的方框已经包含了空白，校验器算「这个框够不够大」时也把静区算了进去。贴在纯白底上、位置实在紧张时可以在大师版属性里把静区调到 1～2 个模块，但设为 0 基本扫不出来。
- 静区内不放文字、边框、图标，浅灰底纹也不行
- 标签本身裁切偏 1mm 是常事，二维码不要贴着标签边放
- 深色标签底要给二维码留一块白色底板，白板边缘就是静区
第四步：算最小尺寸——从模块反推边长
二维码能做多小，取决于两个数：内容需要多少模块，每个模块最少多宽。KuaiLabel 校验器用的最小模块是 0.25mm——低于这个值热敏打印机（203 DPI 每点 0.125mm，一个模块只有 2 个点）画不准，普通扫描器也读不出；实际设计建议 0.4mm 以上。
版本决定模块数：版本 N 的边长是 17 + 4N 个模块。版本 1 是 21×21，版本 2 是 25×25，版本 5 是 37×37，版本 10 是 57×57。最小边长 = (模块数 + 静区 4×2) × 0.25mm。这就是校验器里 qrMinimumSide 的算法，几个常用值：
所以印一条 30 字符的网址（M 级、版本 2），二维码框不能小于 8.25mm，建议 12mm 以上；印 80 字符（版本 5）不能小于 11.25mm，建议 18mm 以上。校验器会算出你当前内容需要的版本，框比最小边长小就报 COD-05「装不下它的内容」，一键修正会把框放大到刚好够用。
- 版本 1（21 模块，M 级约装 14 字节）：最小边长 7.25mm
- 版本 2（25 模块，约 26 字节）：最小边长 8.25mm
- 版本 3（29 模块，约 42 字节）：最小边长 9.25mm
- 版本 5（37 模块，约 84 字节）：最小边长 11.25mm
- 版本 10（57 模块，约 213 字节）：最小边长 16.25mm
第五步：批量打印固定版本，整批格子一样大
批量打印时每条记录的内容长短不一：编号「A001」用版本 1，「A001-20260905-张三」就要版本 3。二维码默认按内容自动选最小版本，结果同一张模板印出来的码有的 21 格、有的 29 格，装在同样大的框里模块宽度不一样，视觉上忽大忽小，模块细的那些还可能扫不出。
解决办法是固定最低版本：找出这批数据里最长的一条，看它需要几版，把二维码的最低版本设成这个数，所有记录都按这个版本生成，短内容用填充补齐。KuaiLabel 大师版二维码属性里的「最低版本」就是干这个的，设好之后整批格子一样大，校验器也会按固定版本算最小边长，不会出现「预览没问题、第 37 条扫不出」的情况。
第六步：验证扫描距离
经验值：手机能稳定扫描的距离约等于二维码边长的 10 倍。15mm 的码在 15cm 内扫，30mm 的码可以在 30cm 扫。反过来，如果标签贴在货架高处、需要站在 1m 外扫，二维码就要做到 100mm 见方。设备铭牌、资产标签一般是近距离扫，15～20mm 够用；货架位、周转区的标识建议 40mm 以上。
打印出来先用两台不同品牌手机各扫 3 次，再用扫码枪扫，都能 1 秒内读出才算过。扫不出先看是不是模块太细（放大二维码），再看是否反光（换哑光材质或斜着扫），最后看静区有没有被侵占。
在 KuaiLabel 里怎么做
在编辑器里拖一个二维码元素，基础版只需填内容，纠错等级（L/M/Q/H，默认 M）、静区（默认 4 模块）、最低版本三项在右上角切到大师版后出现在属性面板里。内容可以绑定数据源字段，批量导出时每条记录生成各自的码。校验器在导出前检查三件事：框是不是正方形（COD-02，不是就改成正方形）、框够不够装下内容（COD-05，按 0.25mm 模块和静区反推）、前景色够不够深（COD-04，浅色会改成纯黑）。
常用场景直接从模板起步，四个模板都已经放好了二维码和配套文字：「溯源二维码」是食品农产品用的网址型二维码加批次信息版式；「资产标签」和「设备标签」是编号型，二维码 + 编号 + 责任人，贴在会磨损的设备表面时建议把纠错改成 Q；「危废标签」按环保要求排好了二维码位置和危废信息栏，户外和化学品环境建议纠错 H。选模板后改内容、绑数据、批量导出即可。
常见问题
二维码最小可以印多大？
取决于内容长度。按 KuaiLabel 校验器的算法，版本 1（约 14 字节）含静区最小 7.25mm，版本 5（约 84 字节）最小 11.25mm，这是「理论能扫」的下限。实际设计建议每个模块 0.4mm 以上，即版本 1 做到 12mm、版本 5 做到 18mm 左右。
二维码纠错等级选哪个？
默认 M（约 15% 可损坏）适合大多数场景。会磨损、沾油污的仓库和设备标签选 Q（约 25%），户外、危废、几年不换的选 H（约 30%）。等级越高码越密，不要为了「保险」一律选 H 然后把码做得很小。
为什么同一批标签的二维码大小不一样？
内容长的记录版本高、模块多，自动版本模式下每条码的格数不同，装进同样大的框里视觉上就忽大忽小。在二维码属性里设置「最低版本」，按最长的一条记录定版本，整批就一样大了。
二维码可以印成彩色或者反白吗？
前景深色、背景浅色是安全组合，深蓝、深绿前景多数手机能扫。反白（白码黑底）部分扫码软件不支持，扫码枪更是基本不认，不建议。KuaiLabel 校验器会拦住前景色太浅的二维码。
二维码里的网址以后改了怎么办？
印在标签上的内容改不了，所以网址应该指向自己能控制的地址，比如自家域名的短链或带编号的查询页，跳转目标在服务端改。直接把第三方长链接印上去，对方一改路径整批标签就作废。
