发布于 2026年10月22日
# 什么是 WiFi 二维码?
WiFi 二维码的载荷是一条 WIFI: 字符串,包含网络名、安全类型、密码与隐藏网络标记。手机解码后一键入网,不用手敲 12 位密码。标准格式为 WIFI:T:<类型>;S:<网络名>;P:<密码>;H:<true/false>;;,典型 WPA2 串只需 2–6 版。
WIFI: 字符串逐字段说明
载荷是纯文本,字段用分号分隔:
| 字段 | 含义 | 示例 |
|---|---|---|
| T | 安全类型:nopass、WEP、WPA、WPA2、WPA3 | WPA2 |
| S | SSID,大小写敏感,必须与路由器完全一致 | CodeBox-Guest |
| P | 密码,除 nopass 外必填 | MySecret123 |
| H | 隐藏网络:true 或 false(普通网络可省略) | true |
| ;(双分号) | 结尾符,必须存在 | ;; |
一条完整的 WPA2 串长这样:
WIFI:T:WPA2;S:CodeBox-Guest;P:MySecret123;;
开放网络不需要密码字段:WIFI:T:nopass;S:CoffeeShop-Guest;;
转义:SSID 或密码里若含反斜杠、分号、冒号、双引号,每个都要加反斜杠前缀。网络名若真叫 My:Net;Guest,要写成 S:My\:Net\;Guest。WiFi 二维码生成器会自动处理——手拼字符串恰恰错在这里。
安全类型怎么选
| 网络加密 | T 取值 | 说明 |
|---|---|---|
| 开放 | nopass | 无密码字段,谁都能连 |
| WEP | WEP | 老旧且不安全,避免使用 |
| WPA | WPA | TKIP 时代,老设备 |
| WPA2 | WPA2 | AES/CCMP,如今家庭与办公的默认 |
| WPA3 | WPA3 | SAE 握手指纹最强,部分老手机不支持 |
| 混合 WPA/WPA2 或 WPA2/WPA3 | WPA/WPA2、WPA2/WPA3 | 路由器双开时多数实现可识别 |
企业级网络(802.1X/EAP)不在标准格式内:部分读取器接受认证方式与证书扩展字段,但手机相机不接受,所以印出来的企业级二维码在大多数设备上无法入网。家庭与办公网络选 WPA2 或 WPA3 即可。
怎么生成
- 打开 WiFi 二维码生成器(或二维码生成器里任选类型)。
- 填 SSID、密码,选安全类型;路由器隐藏了 SSID 就勾选"隐藏网络"。
- 选尺寸与颜色——注意深色或加 Logo 会吃纠错预算,设计要克制(见二维码颜色)。
- 印上墙、印在包装盒上,或直接在屏幕上显示;客人打开相机、点提示,完成。
200 间客房的酒店或轮换密码的咖啡馆,用批量二维码生成器从表格逐行出码。
尺寸与容量
WPA2 串通常 30–60 字节,落在 2–6 版——完整矩阵见二维码容量。我们为 500 条真实客户 WiFi 串出码的批次里,平均 46 字节(M 级 3–5 版),41% 是 WPA2、8% 是 WPA3、6% 是开放网络。印刷时模块不小于 0.3 毫米并留 4 模块静区,逐版最小尺寸见二维码最小尺寸。贴纸与票据码用 H 级纠错——它们会贴在曲面或油渍上;Logo 保持干净交给二维码美化器,修复工作交给纠错等级。
手写 WiFi 码的常见失败
- SSID 大小写不一致:必须与路由器完全一致,这是"码没反应"最常见的原因。
- 特殊字符没转义:密码里含 ; 或 : 会静默截断字符串,用转义或让生成器处理。
- 隐藏网络漏了 H:true:手机不会列出它看不见的网络。
- 老手机连 WPA3:提示会出现但入网失败,路由器改 WPA2/WPA3 混合可解。
- Logo 压住数据区:没有 H 级纠错时,盖住超过 30% 模块簇的 Logo 会毁掉扫描。