二维码生成器

二维码是容器，不是链接

摄像头读到的方块只是字节。让手机提出加入网络而不是显示一句话的，是这些字节的形状：网络的 `WIFI:T:WPA;S:the network;P:the password;;`、邮件的 `mailto:`、号码的 `tel:`、短信的 `SMSTO:`，以及联系人的 version 3.0 vCard。每种格式都有自己的转义规则，也都有自己的失败方式，而且看起来和成功一模一样：码能扫，什么也没打开，错误却看不见。

所以这里的每种载荷的拼装规则都带独立检查。包含分号的 Wi-Fi 密码会被转义，因为有效载荷是分号分隔的列表；姓氏里的逗号会在 vCard 中转义，否则它会开始一个新的姓名字段；手机可能截断的长地址会按 75 个八位组折行并标出续行，这是 vCard 规范的要求。结果面板会打印进入码里的精确有效载荷，因此可以逐字符检查，而不是只能相信。

码的种类也决定扫描器能拿它做什么，仅此而已。二维码不能自己加入网络、发送消息或保存联系人：它填好一张表单，等待人按下按钮。把 Wi-Fi 码贴到墙上之前值得知道这一点，因为密码就在码里。

版本、模式，以及一个短链接为什么变成大方块

二维码有四十种尺寸，称为版本。版本 1 是 21 × 21 个模块，版本 40 是 177 × 177，每升一级每边增加四个模块。自动模式下，会画出能容纳数据的最小版本，因为模块越少，码越小，也越容易扫描；结果会说明用了哪个版本，以及再小一级需要多少空间。

能装多少取决于模式——数字最便宜，其余内容按自己的编码方式计费。这就是为什么一个三十字符的小写链接可能需要比八十位数字更大的符号，也是页面会说明所用模式的原因。

纠错是尺寸的另一半。等级 L 把约 7% 的符号用于修复数据，M 约 15%，Q 约 25%，H 约 30%，所以同一段文本在 H 下需要更大的版本。容量值得随手记住：版本 1 在 M 级可装 14 字节小写文本，版本 10 在 M 级可装 213 字节，版本 40 在 M 级可装 2331 字节，在 L 级可装 2953 字节。码下方的表格列出了全部。

纠错、对比度，以及 logo 的诚实边界

修复数据让扫描器能读取被雨淋过、印得很差或部分被遮住的码。它也是中间放 logo 能成立的原因：H 级能承受约 30% 的符号不可读，所以盖在中央的标记是经过计算的风险，而不是魔法。覆盖超过这个比例，或者在 logo 下面使用 M 级，码会停止扫描，却对人眼依然完好。

纠错修不了的是对比度。扫描器寻找的是明暗模块之间的边界，所以反色码、彩色码，或叠在照片上的码，是手机拒绝一个本来完美的符号的常见原因。白底黑字、平整、四周保留标准的四个模块静区（四条白边），是标准假定的条件，这也是这个页面没有颜色选择器的原因。

纸张上的尺寸是另一个实际限制。一条沿用多年的经验法则：码大约应为扫描距离的十分之一，所以在 30 厘米处读取的码约 3 厘米宽，一米或两米外读取的海报码则要远大于最小值。低于约半毫米的模块在家用打印机上会糊成一片，这也是这里的设置以每模块像素而不是厘米为单位的原因之一。

这个页面检查什么，又刻意省略什么

编码本身是本站唯一没有按规范自己写的部分。条形码是一张条宽表加校验和，所以这里的条形码生成器可以拥有自己的实现并证明表是对的；二维码是有限域上的 Reed-Solomon 算术、八种掩码模式按四条惩罚规则评分，以及随每个版本和每个等级变化的块布局。所以这个页面使用一套成熟的二维码编码器，它完全在你的浏览器里运行，然后我们再检查它的工作，而不是直接相信。

检查在结果里可见。承载纠错等级和掩码模式的十五个格式位会从成品符号中读回，而且从它们写入的两个位置分别读取，两者必须一致；从版本 7 起，符号还会用自身受纠错余数保护的十八位声明版本号，同样会被读回。因此码下方打印的数字是关于图像的事实，而不是设置的重复。

我们还会更进一步，用一个按同一标准独立编写的解码器把输出读回来：每种模式、每个等级、渲染成像素的符号、压缩后的 PNG 再读回，以及容量表的每一行都通过编码恰好该长度和再多一字节的有效载荷来确认。最后这项检查在编写时发现了本页自己表格里的一个真实错误：版本 30 在 Q 级可装 982 字节，而不是原先输入的 964。

以下内容不包含，值得明说：会跳转的动态或可编辑码，这正是“以后再改链接”的真正含义，它把码放在别人的服务器上；扫描分析；logo 和颜色；Micro QR；零售供应链使用的 GS1 Digital Link 和 FNC1 参数；超长有效载荷的结构化追加符号；以及汉字模式。日文在这里按 UTF-8 字节编码，每部手机都能读，只是比专用汉字编码器多占一点空间。