这个工具做什么
这个页面把一段文本编码成二维码图片,整个过程都在当前浏览器里完成:不联网、不调用任何接口、不上传输入内容,也没有任何外部脚本或字体。生成的二维码可以用于网址、纯文本、会议码、设备编号、一段说明,或者任何扫码后需要原样读出的字符串。输出格式是 PNG,尺寸可选 256、512、1024 像素,前景色与背景色也可以自行调整。
二维码(QR Code,Quick Response Code)是 Model 2 标准的二维条码。它把数据编成黑白模块,再附加纠错码,让扫码器即使读不到一部分模块也能还原内容。这个工具自己实现了编码器,包括 Byte 模式数据编码、Reed-Solomon 纠错、模块排布、八种掩码的罚分选择、格式信息与版本信息生成,没有引用任何第三方库或在线服务。因此断网、内网、离线环境都能使用,也不必担心内容被第三方记录。
需要说明的是,页面不保存历史。刷新或关闭页面后,输入框里的文本、生成的图片都不会留下,也不会写入地址栏。需要长期使用的,请在生成后立即下载 PNG,或者把图片另存到本地。
怎么用
在左侧文本框输入内容,选择容错等级与图片尺寸,需要的话调整前景色和背景色,然后点「生成」。右侧会立刻出现二维码预览,下方给出真正使用的版本号、模块数、掩码编号和字节数。确认无误后点「下载 PNG」,浏览器会把图片保存到默认下载目录,文件名带有像素尺寸。
- 文本内容:单行短文本或多行长文本都可以,换行会被原样编码,扫码后能读到同样的换行。上限是 1000 个字符,同时还要满足字节容量。
- 容错等级:L、M、Q、H 四档,默认 M。等级越高,同样内容需要的模块越多,二维码也更密。
- 图片尺寸:256 适合贴在网页或聊天窗口,512 适合大多数打印场景,1024 适合海报、展板或需要放大查看的场合。
- 颜色:默认黑色前景、白色背景。改色时注意保持足够的亮度对比,否则扫码器无法区分模块。
- 清空:把文本、预览和统计一起清掉,容错等级、尺寸与配色保持不变。
生成之后如果又改了容错等级、尺寸或颜色,工具会自动按新参数重绘,不需要再点一次「生成」。如果改的是文本内容,需要手动点「生成」,这样可以避免一边输入一边反复重算,也让预览与输入保持可控的对应关系。
容错等级怎么选
容错等级(Error Correction Level)决定二维码能承受多大比例的损坏仍然可读。四档的近似能力是:L 约 7%,M 约 15%,Q 约 25%,H 约 30%。这里的比例指模块被遮挡、磨损或印刷不清的比例,是标准给出的参考值,不是任何环境下的精确承诺。
- L:容量最大,适合屏幕显示、环境干净、不会被遮挡的场景,例如网页里的跳转链接。
- M:默认档,容量与鲁棒性比较平衡,适合大多数日常用途。
- Q:适合会经过打印、覆膜、贴在物体表面的场合,容忍一定污渍和折痕。
- H:最高容错,适合工业标签、户外标识,或者需要在二维码区域叠加小图标的情况。
同一条内容,等级从 L 提到 H,版本号往往会上升一到三级,模块变得更密。如果二维码要被印得很小,盲目选 H 反而会让每个模块小到难以分辨,实际扫码成功率可能下降。比较稳妥的做法是:先按使用环境选一个够用的等级,再看打印尺寸是否让模块边长不小于 0.4 毫米;两者冲突时,优先保证模块够大,其次才是容错等级。
本工具在内容超限时会直接提示「内容过长,请缩短文本或降低容错等级」,不会生成一个装不下的半成品。上限按最大版本 20 计算:L 级约 858 字节,M 级约 666 字节,Q 级约 482 字节,H 级约 382 字节,实际数值以输入框下方的提示为准。注意中文按 UTF-8 占 3 个字节,1000 个字符的中文很可能超过容量,这时需要缩短文本,而不是反复调整尺寸。
尺寸与清晰度怎么选
尺寸选择的是输出 PNG 的像素边长,不是二维码的模块数。模块数由版本决定,版本又由内容长度与容错等级决定。例如默认示例在 M 级下是版本 2,模块阵列 25 × 25;再加上四周各 4 个模块的静区,整体是 33 × 33 个格子。选 512 像素时,每个模块约 15.5 像素,绘制时按整数边界取整,边缘依然清晰。
二维码四周必须留出静区(quiet zone),也就是空白边距。标准要求至少 4 个模块宽,本工具固定按 4 个模块绘制,不会贴边。如果把生成的图片再裁切、加边框,或者贴到深色背景上,一定要保留这段白边,否则扫码器可能找不到二维码的边界。
- 屏幕展示:256 或 512 就够。展示时不要用样式把图片缩到小于 120 像素,模块会糊在一起。
- 普通打印:512 像素大约相当于 4 厘米见方、300 dpi 的清晰度,名片、标签、宣传单都合适。
- 大幅面:海报、展板选 1024。若需要更大,应当重新用更大尺寸生成,而不是把 256 的图强行拉大。
- 缩放与压缩:不要用有损压缩反复处理二维码;截图、聊天软件转发都可能引入模糊,正式使用请用下载得到的 PNG 原图。
还要区分「模块数」和「像素数」:模块数越多,同样像素下每个模块越小。内容特别长时,即使选 1024 像素,模块也可能只有几个像素宽,打印出来仍然困难。遇到这种情况,更有效的做法是缩短内容,例如把长链接换成短链接,或者把说明文字放到二维码之外,而不是一味提高输出尺寸。
常见情况
中文显示乱码
本工具按 UTF-8 编码文本,编码前用浏览器的 TextEncoder 把字符串转成字节,因此中文、日文、常见符号都能正确写入。扫码后出现乱码,通常不是生成端的问题,而是扫码软件按 GBK 或其他编码解释字节。可以换一个扫码器对比,或者把内容改成纯 ASCII,例如只保留链接和数字。部分老旧设备只支持 ASCII,这是设备本身的限制。
长链接放不下
网址里常带大量跟踪参数,长度很容易超过几百字节。在 M 级下,版本 20 最多约 666 字节,超出就会提示内容过长。处理办法有三个:删掉无用的查询参数;使用短链接服务;把链接指向一个中转页。不要靠降低容错等级硬塞,L 级只比 M 级多约 190 字节,收益有限,鲁棒性却明显下降。
颜色对比度不足
二维码识别依赖深浅对比。前景与背景的亮度差太小时,扫码器无法区分模块。页面会计算两者的对比度,低于 3:1 时给出警告。深色前景配浅色背景最稳妥;反色(浅色前景、深色背景)虽然对比度可能很高,但不少扫码器默认只找「深色模块、浅色底」,容易失败,所以不建议。另外,红配绿、蓝配紫这类亮度接近的组合也不要用。
扫描不出来怎么排查
- 确认图片没有被裁掉静区,四周至少保留 4 个模块的空白。
- 确认展示尺寸足够大,屏幕上每个模块至少 3 到 4 个像素。
- 确认没有经过有损压缩、锐化或滤镜处理。
- 换一个扫码应用对比,排除单个软件的问题。
- 内容过长时先缩短文本,再重新生成。
- 打印件检查墨色是否均匀,反光、覆膜气泡都会影响识别。
实现说明与限制
编码器完全内联在页面脚本里,只做 Byte 模式。流程是:文本经 UTF-8 转成字节;按容错等级和字节数自动选择版本 1 到 20;写入模式指示、字符计数、数据字节、终止符和填充码字;按标准分块并计算 Reed-Solomon 纠错码字;把数据码字与纠错码字交织;在矩阵中放置定位、分隔、定时、对齐图形与固定深色模块;对 8 种掩码逐一计算罚分,选出罚分最低的一种;最后写入格式信息与版本信息。全部计算在内存中完成,没有网络请求,也不使用本地存储。
限制有几点。第一,只支持 Byte 模式,不会像专业库那样把纯数字或大写字母自动切成更紧凑的数字模式、字母数字模式,因此同样的内容可能比商业工具多用一个版本。第二,版本上限为 20,超过就提示内容过长,不生成部分数据。第三,文本长度限制 1000 个字符,这是交互上的保护,实际能否装下仍以字节容量为准。第四,不提供叠加图标、圆点样式、渐变等美化选项,因为这类改动会直接降低可读性。
关于隐私:页面不发起任何网络请求,不使用任何远程接口或埋点上报,也不把内容写进地址栏。输入的文本只存在于当前页面的内存里,关闭页面即消失。下载动作由浏览器本地完成,图片不会经过服务器。这一点与站内其他工具页保持一致。