生成器

二维码生成器

生成二维码,支持自定义样式和多种导出格式

undefined
undefined:
undefined
undefined
  • undefined
  • undefined
  • undefined
  • undefined

什么是二维码?

二维码(QR Code)是一种矩阵式二维条码,可以存储大量信息。相比传统条形码,二维码可以存储更多数据,支持多种字符编码,广泛应用于移动支付、产品追踪、信息分享等场景。

纠错级别说明

  • L (Low):约 7% 容错,适合简单场景
  • M (Medium):约 15% 容错,推荐使用
  • Q (Quartile):约 25% 容错,适合复杂环境
  • H (High):约 30% 容错,最高容错率

使用场景

  • URL 分享:快速分享网站链接
  • 联系方式:生成包含电话、邮箱的二维码
  • WiFi 密码:生成 WiFi 连接二维码
  • 文本信息:存储任意文本内容
  • 产品标识:商品信息、序列号等

格式说明

  • PNG:位图格式,适合网页使用,文件较小
  • SVG:矢量格式,可无损缩放,适合打印
  • Data URL:Base64 编码的图片数据,可直接嵌入 HTML

二维码生成器把文本、网址、Wi-Fi 凭据或经纬度坐标编码成 ISO/IEC 18004 符号,可导出 PNG、SVG 与 Base64 data URL。适合把印刷物料指向线上页面、给访客分享临时网络,或在不托管文件的前提下把一个图形直接嵌进网页。

width 按像素,margin 按模块

width 是导出图片的总像素边长,margin 的单位却是模块而不是像素,两者合成同一个缩放系数:width ÷(模块数 + 2 × margin),再套用到每一个模块。默认输入是 30 个 UTF-8 字节,在 M 级纠错下需要 version 3,即 29 × 29 的方格;margin 取 4 之后总宽变成 37 个单元,所以导出 256 px 时每个模块只有 6.92 px。除数不是整数,模块边缘就会落在两个像素之间,小尺寸 PNG 因此显得毛糙、深浅不一;把 width 设成 37 的整数倍,每个模块才严格等宽。SVG 没有这个毛病:它写出 viewBox="0 0 37 37" 与 shape-rendering="crispEdges",width 只作为显示尺寸记录。

四种分段模式,每字符成本不同

数据按分段存储,分段所用模式决定了单个字符要花多少比特:数字模式用 10 比特装 3 个数字,字母数字模式用 11 比特装 2 个字符,字节模式每字节 8 比特,汉字模式用 13 比特装一个 Shift-JIS 字符。编码器给每一段单独选模式,于是字符数相同的数据可能落在不同版本上:30 个数字在 M 级只要 version 1(21 × 21),30 个 ASCII 字母却要 version 3(29 × 29)。非 ASCII 文本还要多付 UTF-8 的账,25 个汉字在字节模式下是 75 字节,M 级直接被推到 version 5(37 × 37)。与其下调纠错等级,不如先砍掉 URL 里的追踪参数。

扫不出来的两个真实原因

第一是颜色。模块必须比背景深,而两个 hex 输入框只是把颜色直接换算成像素通道:接受 3、4、6、8 位 hex,其余写法会生成失败。red 这类 CSS 颜色名不会报错,它被解析成全零通道、透明度也为零,结果是整张图空白而不是功能报错。把深色与浅色对调(浅色模块、深色底)时,部分手机 App 仍能识别,许多手持扫码枪会直接拒绝。第二是载荷语法。mailto:、geo:、WIFI: 这些前缀是扫码软件各自约定的格式,不属于二维码标准,各有各的转义规则:在 WIFI: 载荷里,分号必须写成反斜杠加一个分号,否则字段提前结束,密码就在那里被截断。

实操示例

按默认输入算一遍模块尺寸

输入
https://devtoolbox.example.com
输出
M 级纠错 → version 3,29 × 29 模块;margin 4 → 37 × 37 单元;256 px ÷ 37 = 6.92 px/模块

这个字符串正好 30 字节,而 M 级 version 2 的字节容量只有 26 字节,编码器因此跳到 version 3。四周各留 4 个模块,总宽变成 37 个单元,这也是导出图比 29 × 29 更宽的原因。SVG 把同样的 37 单元写进 viewBox,放大到任何印刷尺寸都不会糊。

边界与常见误用

  • 容量上限按字节算:L 级 2,953 字节、H 级 1,273 字节(version 40、字节模式),超出后编码库抛错,页面只显示一次笼统的生成失败。
  • margin 取值 0–10,单位是模块;填 0 等于去掉标准要求的静区,很多扫码器会因此拒绝识别。
  • width 是含外边距的总像素边长,不是模块大小;当它小于「模块数 + 2 × margin」时编码库会忽略该值,退回每模块 4 px 的内部缩放。
  • 预览下方的版本与容量是按字符数查表估出来的(阈值 25 / 47 / 77 / 114),不看分段模式与纠错等级:10 个汉字会被标成很小的版本,实际却是 29 × 29。
  • 输入按 UTF-16 长度计数,一个 emoji 算 2 个字符,但在字节模式下要占 4 个字节,容量估算会偏乐观。

相关工具

出问题时先看这里

「我把文字改了,下面的图还是旧的那张。」

原因文本框、纠错等级、margin、width 共用同一个 500 ms 定时器,而每次生成都会在「先出 PNG、再出 SVG」的整段时间里占住 isGenerating。这期间触发的定时器回调只是直接 return,既不出图也不重新排队,那次修改就被吞掉了。

处理点「重新生成」:它会清掉待执行的定时器并立刻编码,成功提示出现即代表屏幕上那张图是新生成的。别只用肉眼判断预览有没有更新。

「手输 hex 颜色时预览一直闪,最后停在不是我想要的颜色上。」

原因颜色输入框绑的是 @input,每敲一个字符就改写 darkColor 并重置 500 ms 定时器。输到一半时的值可能是 5 个字符,这个长度会被颜色解析拒绝,生成失败后旧图留在原地,看起来就像「改到一半没反应」。

处理整段粘贴,或者直接用旁边的取色器——它只会给出 7 位 hex。改完看信息面板里的「前景色」,那里显示的是最后一次成功生成真正用上的值。

「手机扫我的中文一点问题没有,仓库那把扫码枪出来的全是乱码。」

原因文本经 TextEncoder 编成字节段,且不写 ECI 指示符,于是载荷是裸 UTF-8,没有任何地方声明字符集。按默认 ISO-8859-1 解读的读码器会把每个三字节汉字拆成三个 Latin-1 字形,手机 App 则会直接猜 UTF-8。

处理先看版本是不是被顶大了——这里每个汉字要占 3 个字节;如果扫码枪是固件写死的硬件,就别直接编中文,改成一个 ASCII 短链,让扫码后跳到那段文字。

「把 Data URL 贴进公司 wiki,图裂了,页面还变重了。」

原因「复制 Data URL」交出去的是整张 PNG 的 base64:约为二进制体积的 4/3,再加 22 字符前缀,合起来是不换行的一整行。wiki、邮件客户端和 CMS 的清洗规则都会截断或折行过长的属性值,而折过行的 base64 已经不是合法图片了。

处理改成复制 SVG 内联,或者下载 PNG 后用文件路径引用。两者都让文档保持小巧可改;Data URL 只适合一次性粘贴的临时片段。

「我把文字删了,那张旧二维码还在,居然还能下载。」

原因监听器只在 trim 之后非空时才重新生成,而只有「清空」按钮会把 qrCodeDataUrl 与 qrCodeSvg 一并置空。预览区块的显示条件是 v-if="qrCodeDataUrl",那个没被清掉的字符串就一直挂着旧图,连同下载、复制按钮一起。

处理用「清空」,别用全选删除。文件发出之前确认「内容长度」显示 0,或者确认重新生成的成功提示对应的是你想发出去的那版内容。

什么时候用本页就够,什么时候该换工具

你要决定的事本页的做法该换成什么
传单或海报上只需要一张码下 SVG。默认那 30 个字节在 margin 4 下写成 viewBox="0 0 37 37",印刷厂放到任意尺寸都不用重采样,模块边缘落在整数单元上。qrencode -t EPS -m 4 -s 6 "https://example.com" 直接出 EPS 交给排版软件,还能写进构建脚本,全程不开浏览器。
五十条链接,每条都要单独一张只有一个文本框、一次点击下一张文件,文件名是 qrcode-<时间戳>.png。页面没有批量入口,五十张就是五十轮粘贴加下载。qrencode -r links.txt -o out.png 按行读入,依次写出 out-01.png、out-02.png:编码规则和本页完全相同,只是循环由它代劳。
码要直接写进 HTML 或 Markdown 里「复制 Data URL」给的是 data:image/png;base64,…,一整行,长度约为 PNG 字节数的 4/3 再加 22 字符的 data:image/png;base64, 前缀。能用,但行很长,粘进去就改不动了。改复制 SVG 内联:37 单元的 viewBox 在容器宽度变化时原样保留,两条 path 还能交给 CSS 换色,站点切深色主题时不用重新出图。
码中间要嵌一个 logo只开放前景与背景两个颜色通道,模块一律是方块,没有可以放图片的图层,叠图只能导出后另做。用 Pillow 或 qr-code-styling 叠图,纠错留在 H 级:标准允许读码器恢复约 30% 的码字,被 logo 盖住的模块靠这份冗余兜底。
想证明导出的文件真能解出原文页面上唯一的验证手段是拿手机对着预览扫。没有任何一步把文件读回文本,所以在某类扫码枪上会失败的码,在这里看是一点问题都没有。zbarimg -q out.png 会打印解出的字符串,CI 里拿它跟输入逐字节比对,不一致就让流水线失败——这一步本页替你做不了。
客人现在就要连 Wi-FiWiFi 模板会预先填好 WIFI:T:WPA;S:NetworkName;P:Password;;,三个字段还得手改。生成一张够用,但站在走廊里用手机改就很别扭。路由器后台和两个手机系统都能原生生成同样的载荷,出来的码一模一样,谁在手边就用谁,不必为一张码开电脑。

常见问题

一个二维码最多能装多少数据?
在最低纠错等级下,最多约 4,296 个字母数字字符或 7,089 个数字。纠错等级越高、二进制内容越多,容量下降越快。为保证易扫,URL 尽量短、码点密度尽量低。
应该选哪个纠错等级?
L 容量最大;H 抗污损能力最强(约 30%),在码中央加 Logo 时必须用 H。屏幕显示用 L 或 M 即可;可能磨损的印刷贴纸建议 Q 或 H。
二维码会过期吗?
不会。二维码只是数据的可视化编码,只要被编码的内容本身有效就能一直扫。"失效"的二维码几乎都是因为背后的 URL 下线了。

内容复核: