公告 新用户注册即享 免费 SSL 证书 · 域名批量查询单次支持 40 个 · 香港与内地节点均可自助开通
解决方案 帮助中心 关于我们
代理合作 控制台 登录 免费注册

二维码生成

把文本编码成二维码,四档容错、三种尺寸、可自定义前后景颜色,生成后可直接下载 PNG。编码器在页面内自行实现,不依赖任何外部接口。

本地生成:二维码完全在本地生成,文本不会上传服务器。页面不保存历史记录,关闭或刷新后输入内容即消失。

参数

0 个字符 · 0 字节
#000000
#ffffff
输入文本后点「生成」。默认 M 级容错、512 像素,适合屏幕查看与普通打印。

结果

512 × 512 px

生成的二维码会显示在这里
四周自动保留 4 个模块的静区

这个工具做什么

这个页面把一段文本编码成二维码图片,整个过程都在当前浏览器里完成:不联网、不调用任何接口、不上传输入内容,也没有任何外部脚本或字体。生成的二维码可以用于网址、纯文本、会议码、设备编号、一段说明,或者任何扫码后需要原样读出的字符串。输出格式是 PNG,尺寸可选 256、512、1024 像素,前景色与背景色也可以自行调整。

二维码(QR Code,Quick Response Code)是 Model 2 标准的二维条码。它把数据编成黑白模块,再附加纠错码,让扫码器即使读不到一部分模块也能还原内容。这个工具自己实现了编码器,包括 Byte 模式数据编码、Reed-Solomon 纠错、模块排布、八种掩码的罚分选择、格式信息与版本信息生成,没有引用任何第三方库或在线服务。因此断网、内网、离线环境都能使用,也不必担心内容被第三方记录。

需要说明的是,页面不保存历史。刷新或关闭页面后,输入框里的文本、生成的图片都不会留下,也不会写入地址栏。需要长期使用的,请在生成后立即下载 PNG,或者把图片另存到本地。

怎么用

在左侧文本框输入内容,选择容错等级与图片尺寸,需要的话调整前景色和背景色,然后点「生成」。右侧会立刻出现二维码预览,下方给出真正使用的版本号、模块数、掩码编号和字节数。确认无误后点「下载 PNG」,浏览器会把图片保存到默认下载目录,文件名带有像素尺寸。

生成之后如果又改了容错等级、尺寸或颜色,工具会自动按新参数重绘,不需要再点一次「生成」。如果改的是文本内容,需要手动点「生成」,这样可以避免一边输入一边反复重算,也让预览与输入保持可控的对应关系。

容错等级怎么选

容错等级(Error Correction Level)决定二维码能承受多大比例的损坏仍然可读。四档的近似能力是:L 约 7%,M 约 15%,Q 约 25%,H 约 30%。这里的比例指模块被遮挡、磨损或印刷不清的比例,是标准给出的参考值,不是任何环境下的精确承诺。

同一条内容,等级从 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 个模块绘制,不会贴边。如果把生成的图片再裁切、加边框,或者贴到深色背景上,一定要保留这段白边,否则扫码器可能找不到二维码的边界。

还要区分「模块数」和「像素数」:模块数越多,同样像素下每个模块越小。内容特别长时,即使选 1024 像素,模块也可能只有几个像素宽,打印出来仍然困难。遇到这种情况,更有效的做法是缩短内容,例如把长链接换成短链接,或者把说明文字放到二维码之外,而不是一味提高输出尺寸。

常见情况

中文显示乱码

本工具按 UTF-8 编码文本,编码前用浏览器的 TextEncoder 把字符串转成字节,因此中文、日文、常见符号都能正确写入。扫码后出现乱码,通常不是生成端的问题,而是扫码软件按 GBK 或其他编码解释字节。可以换一个扫码器对比,或者把内容改成纯 ASCII,例如只保留链接和数字。部分老旧设备只支持 ASCII,这是设备本身的限制。

长链接放不下

网址里常带大量跟踪参数,长度很容易超过几百字节。在 M 级下,版本 20 最多约 666 字节,超出就会提示内容过长。处理办法有三个:删掉无用的查询参数;使用短链接服务;把链接指向一个中转页。不要靠降低容错等级硬塞,L 级只比 M 级多约 190 字节,收益有限,鲁棒性却明显下降。

颜色对比度不足

二维码识别依赖深浅对比。前景与背景的亮度差太小时,扫码器无法区分模块。页面会计算两者的对比度,低于 3:1 时给出警告。深色前景配浅色背景最稳妥;反色(浅色前景、深色背景)虽然对比度可能很高,但不少扫码器默认只找「深色模块、浅色底」,容易失败,所以不建议。另外,红配绿、蓝配紫这类亮度接近的组合也不要用。

扫描不出来怎么排查

实现说明与限制

编码器完全内联在页面脚本里,只做 Byte 模式。流程是:文本经 UTF-8 转成字节;按容错等级和字节数自动选择版本 1 到 20;写入模式指示、字符计数、数据字节、终止符和填充码字;按标准分块并计算 Reed-Solomon 纠错码字;把数据码字与纠错码字交织;在矩阵中放置定位、分隔、定时、对齐图形与固定深色模块;对 8 种掩码逐一计算罚分,选出罚分最低的一种;最后写入格式信息与版本信息。全部计算在内存中完成,没有网络请求,也不使用本地存储。

限制有几点。第一,只支持 Byte 模式,不会像专业库那样把纯数字或大写字母自动切成更紧凑的数字模式、字母数字模式,因此同样的内容可能比商业工具多用一个版本。第二,版本上限为 20,超过就提示内容过长,不生成部分数据。第三,文本长度限制 1000 个字符,这是交互上的保护,实际能否装下仍以字节容量为准。第四,不提供叠加图标、圆点样式、渐变等美化选项,因为这类改动会直接降低可读性。

关于隐私:页面不发起任何网络请求,不使用任何远程接口或埋点上报,也不把内容写进地址栏。输入的文本只存在于当前页面的内存里,关闭页面即消失。下载动作由浏览器本地完成,图片不会经过服务器。这一点与站内其他工具页保持一致。

一句话总结:内容短、环境干净选 M;要打印或可能磨损选 Q 或 H;尺寸按最终展示大小选,务必保留四周静区,深色前景配浅色背景。

下一步:解决素材的存储与分发

二维码生成的结果要落地,还需要考虑存放空间与分发线路,这决定了实际打开速度。

推荐产品 虚拟主机 活动页与二维码落地页用虚拟主机部署最快。 查看空间与流量
需要协助 提交工单 需要批量处理或迁移素材,提交工单说明数量与格式。 提交工单