二维码生成器 — URL / WiFi / vCard / Email / SMS / 位置

什么是二维码？

// Build a WiFi payload and generate an SVG QR
import QRCode from 'qrcode';

// 1. WIFI: protocol (de facto, recognized by iOS+Android)
const payload = 'WIFI:T:WPA;S:My\\;Network;P:p@ss\\;word;H:false;;';

// 2. Generate SVG (vector, scales without pixelation)
const svg = await QRCode.toString(payload, {
  type: 'svg',
  errorCorrectionLevel: 'M',
  margin: 4,
  color: { dark: '#000000', light: '#ffffff' },
});

// 3. Drop into the DOM (DOMParser-safe, not innerHTML)
const doc = new DOMParser().parseFromString(svg, 'image/svg+xml');
preview.replaceChildren(doc.documentElement);

核心特性

示例

https://go-tools.org

SSID: Cafe WiFi / WPA2 / 密码: visitor2026

Ada Lovelace / Acme Corp / +1 555 0100 / ada@acme.test

纬度 40.7829，经度 -73.9654（纽约中央公园）

使用步骤

1. 1

   选择数据类型

   选择对应的标签页：URL 用于网址，WiFi 用于网络分享，vCard 用于联系人，Email / SMS 用于预填邮件或短信，Location 用于地图坐标，Plain Text 用于任意文本。

2. 2

   填写字段

   每个标签页只展示该类型相关的字段。WiFi 需要 SSID、密码、安全类型；vCard 接受姓名、电话、邮箱、公司、网址。预览随输入实时更新。

3. 3

   自定义（可选）

   在 Customize 面板中调整 ECC 级别（屏幕用 M，印刷用 H）、尺寸（200-1024 px）、前景与背景色。对比度过低时工具会主动提示，避免印好后才发现扫不出。

4. 4

   下载 SVG 或 PNG

   点击 Download SVG 获得矢量图（可任意缩放，适合印刷）；或从下拉菜单选 PNG 尺寸（256 / 512 / 1024 px）。Copy SVG 可直接粘贴到 Figma 等设计工具。

常见二维码误区

QR encodes: https://bit.ly/abc → 404 after subscription lapses

QR encodes: https://your-domain.com/menu directly

FG #cccccc on BG #ffffff (ratio 1.6:1)

FG #003366 on BG #ffffff (ratio 12.6:1)

WIFI:T:WPA;S:Cafe;P:p@ss;word;; (parser breaks at the unescaped ;)

WIFI:T:WPA;S:Cafe;P:p@ss\;word;;

Print poster, ECC=L, partially folded → unreadable

Print poster, ECC=H → readable even with 30% damage

40% logo over center → fails on Samsung phones

15% logo, ECC=H → reliable across phones

?utm_source=...&utm_medium=...&utm_campaign=... (350 chars at M → reject)

Use /go/spring (35 chars) with server-side redirect to the long URL

常见使用场景

餐厅菜单

把 URL 二维码印在餐桌上，顾客用手机查看菜单。静态二维码意味着即使更换菜单托管服务，也不影响扫描。

访客 WiFi

把 WiFi 二维码贴在家门口、咖啡馆、会议室——访客扫一扫即加入网络，再也不用念密码。

活动签到

把指向报名页的 URL 二维码印在票券、易拉宝、胸牌、挂绳上，所有摄影师拍到的画面都是一次潜在签到。

纸质名片

在名片上加 vCard 二维码——扫描即保存联系人。比让对方手动输入信息的保存率高约 4 倍。

门店与场地定位

geo: 二维码直接在地图 App 中落点——适合房产广告、餐厅传单、会场标识、婚礼请柬。

宣传海报

带 UTM 参数的 URL 二维码可追踪线下渠道转化。静态二维码即使分析平台关停也不会失效。

产品包装

在外包装上编码保修、说明书、注册页 URL。请用 ECC=H 级别，让二维码扛过运输刮伤、压痕、折角。

博物馆与展品标签

音频导览、深度内容、多语言版本——观众用自己的手机即可获取丰富内容，无需印发笨重的纸质手册。

技术细节

符合 ISO/IEC 18004:2015

输出严格遵循 QR Code 国际标准。Version 1 至 Version 40（21×21 至 177×177 modules）按内容大小与 ECC 级别自动选取。

Reed-Solomon 错误纠正

二维码使用 Reed-Solomon 编码恢复损坏或遮挡区域。L / M / Q / H 分别可恢复约 7% / 15% / 25% / 30% 数据。级别越高冗余越多，二维码体积也越大。

标准 URI 协议

WIFI: 协议（iOS/Android 事实标准）、mailto:（RFC 6068）、sms:（RFC 5724）、geo:（RFC 5870）。联系人使用 vCard 3.0（RFC 2426）——比 vCard 4.0（RFC 6350）扫描器兼容性更广。iOS 和 Android 内置相机均原生识别。

自动选择编码模式

qrcode 库根据输入自动选择最优编码方式（numeric / alphanumeric / byte / kanji）。非 ASCII 文本（含 emoji 与中日韩字符）使用 UTF-8 byte 模式。

最佳实践

不要裁掉静默区（quiet zone）

二维码周围需要 4 个 module 宽的背景色边距，本工具默认包含。即使在排版中看起来像浪费空白，也不要裁掉，否则扫描会失败。

印刷品请用 ECC=H 级别

印刷品对二维码不友好——褪色、刮痕、折痕都会损伤模块。ECC=H（~30% 恢复）能救命，纯屏幕用 M 即可。

对比度保持 4.5:1 以上

扫描器靠深浅模块对比度识别。坚持深色前景配浅色背景。反过来（浅前景配深背景）有些手机能扫，更多手机会失败。

iOS 与 Android 都要实测

iOS Camera 自 iOS 11 起原生扫描二维码。Android 厂商表现差异较大——三星、Pixel、小米行为略有不同。在量产 1 万张传单前两端都测一次。

用 HTTPS 与短 URL

URL 越长，二维码越密集（modules 越小，扫描越难）。如果跟踪 URL 超过 200 字符，请走自有的静态短链——不要用 Bitly 这类会过期的服务。

常见问题