二维码有 40 个版本，第 n 版的边长是 n × 4 + 17 个模块（版本 1 是 21×21）。 内容越多版本越高、模块越密，同样尺寸下就越难扫。 上表最后一列是版本 40（177×177）在字节模式下的上限，实际可用容量还跟内容编码模式有关： 纯数字最省，字母数字次之，中文按 UTF-8 占 3 字节。

为什么内容不会外泄：生成用的是 qrcode-generator，识别用的是 jsqr， 两个库都在本机 vendor/ 目录里，全程没有任何请求发出去 —— 断网也能用。 所以拿它处理 WiFi 密码、内网地址这类内容也没问题。
扫不出来怎么办：

• 二维码在图片里太小 —— 裁剪到只剩二维码再试，识别前会先按最长边缩放。
• 图片是反色（白码黑底）或对比度很低 —— 本工具会额外尝试反色解码一次。
• 屏幕截图带缩放模糊 —— 尽量用原图，不要经过聊天软件二次压缩。
• 码本身有损坏 —— 换个容错等级重新生成；H 能扛住约 30% 的面积缺失。

关于边距：二维码四周必须留白（规范要求至少 4 个模块），留白不够会让扫描器找不到边界。 做成贴边的图时记得手动补白。