WiFi 二维码本质上是一张包含结构化文本载荷的二维码。兼容手机扫码后，可以识别网络名称、加密类型、密码和隐藏网络标记，再询问用户是否连接。
生成图片通常不难，失败更多来自格式错误、字符未转义、对比度不足或没有充分测试。下面的流程采用常见 QR 阅读器和手机相机实现的事实标准 WIFI 格式。
先理解 WIFI 载荷
常见密码网络使用下面的结构。T 表示认证类型，S 是 SSID，P 是密码，末尾两个分号用于结束载荷。
| 字段 | 含义 | 示例 |
|---|---|---|
| T | 认证类型 | WPA、WEP、WPA2-EAP 或 nopass |
| S | 网络 SSID，必填 | Studio Network |
| P | 密码；nopass 时省略 | correct-horse-battery-staple |
| H | 隐藏 SSID 标志，可选 | true |
WIFI:T:WPA;S:Studio Network;P:correct-horse-battery-staple;;第 1 步：收集并判断网络信息
准确复制 SSID，包括大小写和空格；确认网络使用 WPA 系列、WEP、企业认证还是无密码；如果网络隐藏，也要明确记录。不要根据密码形式猜测安全类型。
- 优先使用访客网络，不暴露家庭或办公室主网络凭据。
- 确认连接后是否还需要通过 Portal 接受条款。
- 提前考虑打印或展示位置能被哪些人看到。
- 制作长期标牌前先规划凭据轮换时间。
第 2 步：转义特殊字符
反斜杠、分号、逗号、双引号和冒号具有结构含义，出现在字段值中时应在前面加反斜杠。未转义是二维码看似正常、实际密码或 SSID 被截断的最常见原因。
SSID：Cafe;Guest\5G
载荷字段：Cafe\;Guest\\5G
密码：tea:milk,2026
载荷字段：tea\:milk\,2026第 3 步：按网络类型构造载荷
使用下面对应模板，并把字段替换为已转义的值。字段顺序可以调整，但保持固定顺序更方便人工检查。
WPA 网络
WIFI:T:WPA;S:Studio Network;P:correct-horse-battery-staple;;
开放网络
WIFI:T:nopass;S:Guest Lounge;;
隐藏 WPA 网络
WIFI:T:WPA;S:Hidden Lab;P:sample-password;H:true;;第 4 步：在本地生成并选择可靠样式
把载荷粘贴到二维码生成器，或使用结构化 WiFi 表单。深色前景搭配浅色背景，四周保留静默区，不要修改三个定位方块。内容越长，二维码越密，需要更大的输出尺寸。
- 优先使用黑底模块和白色背景。
- Logo 保持较小，只有装饰确有需要时才提高纠错级别。
- 根据最终物理尺寸导出足够分辨率。
- 不要截取很小的预览图再放大打印。
第 5 步：验证载荷和真实扫码
先解码导出的二维码文件，确认文本完全正确；再尽量用至少一台 iOS 和一台 Android 设备，从实际使用距离扫码。接受连接前核对手机显示的 SSID。必须测试最终印刷品，而不只是明亮显示器上的源 PNG。
WiFi 二维码故障排查
失败时应区分图片识别问题和载荷问题。先尝试把图片解码为普通文本：解码失败就提高尺寸、对比度和静默区；文本能解码但手机不提示连接，则逐项检查字段与转义。
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 任何扫码器都无法识别 | 对比低、模糊、裁切或内容太密 | 增大尺寸并保留完整静默区 |
| 能解码文本但不提示连接 | WIFI 格式错误或认证不兼容 | 检查 T、S、P、H、转义和结束符 |
| SSID 被截断 | 分号或反斜杠未转义 | 转义字段值中的全部结构字符 |
| 载荷正确但连接到错误网络 | 附近存在同名 SSID | 重命名访客网络或连接前确认 |
| 旧设备无法连接 | 扫码器或认证支持不同 | 同时提供 SSID 和密码文字备用 |
把二维码当作可见密码
WiFi 二维码不会加密密码。任何能拍摄或解码图片的人都能恢复载荷。应使用访客网络、隔离不受信任客户端、限制展示位置，并在访问应结束时同时更换标牌和凭据。
总结
可靠的 WiFi 二维码需要正确字段、完整转义、清晰图形和真机测试。优先使用隔离的访客凭据，同时验证解码文本与连接提示，并记住便利性不会让二维码中的密码自动保密。