WiFi 二维码格式详解
那段以 WIFI: 开头的纯文本,是整个扫码连网流程里唯一真正重要的东西。写错一个分号,手机上就什么都不会发生。
二维码本身只是容器,真正决定能不能连网的是里面的字符串。这套格式没有 ISO 标准号,是由安卓与 iOS 共同沿用、逐步固定下来的事实约定。也正因为它是约定而非标准,各家解析器的容错程度并不一致,写的时候需要按最严格的那种来要求自己。
一、基本结构
WIFI:T:WPA;S:MyNetwork;P:MyPassword;H:false;;
| 字段 | 含义 | 取值 | 是否必填 |
|---|---|---|---|
T | 加密方式 | WPA / WEP / nopass | 建议始终填写 |
S | SSID,网络名称 | 任意字符串,区分大小写 | 必填 |
P | 密码 | 任意字符串;开放网络留空 | 有密码时必填 |
H | 是否为隐藏网络 | true / false | 可省略,默认 false |
字段顺序在实践中不敏感,但主流生成器都按 T → S → P → H 输出。结尾的双分号是终止标记:第一个分号关闭最后一个字段,第二个分号表示记录结束。少写一个,部分解析器会把后续内容当成新字段。
二、转义:最容易出错的地方
以下字符在字段值内必须写成「反斜杠 + 原字符」:
| 原字符 | 写法 | 不转义的后果 |
|---|---|---|
; | \; | 被当作字段分隔符,密码被截断 |
, | \, | 部分解析器视为字段分隔 |
: | \: | 可能被误读为键值分隔 |
" | \" | 引号可以闭合字符串,导致结构错乱 |
\ | \\ | 吞掉后一个字符 |
一个真实例子:密码是 Sun;set2026,正确写法是 P:Sun\;set2026。如果不转义,解析器读到的密码只有 Sun,手机上就会提示密码错误。
顺便提醒:路由器后台里看到的密码是「人类视角」,二维码里放的是「解析视角」。含特殊字符的密码,务必用扫码 App 解析一次导出结果,肉眼确认整串都在。
三、几种常见变体怎么填
开放网络
WIFI:T:nopass;S:Cafe-Guest;;
P 可以留空。如果误写成 T:WPA 却没有密码,手机会尝试带密码连接并失败。
隐藏网络
WIFI:T:WPA;S:Office-Internal;P:pass1234;H:true;;
H:true 让手机主动探测这个不广播的 SSID。安卓普遍支持;iOS 的部分版本对手动确认的依赖更强,必要时仍需引导用户手动选网。
WPA3 个人版
沿用 T:WPA。WPA3 与 WPA2 在协议层不同,但对这套二维码格式来说,个人版都归入 WPA 这一取值。
企业级 802.1X
无法表达。该格式没有用户名、证书、EAP 类型等字段,把 SSID 与密码写进去也连不上。正确做法是用「自定义文本 / 链接」模式,把码指向内部上网指引或门户认证页。
四、iOS 与安卓的解析差异
- iOS:系统相机(iOS 11 起)识别 WiFi 内容后弹出「加入网络」提示,确认即连。对字段缺失比较敏感,
T缺失时常常直接忽略。 - 安卓:Android 10 起系统相机与 Google Lens 支持;不同厂商的兼容性有差异,部分定制系统只在自己的扫一扫里可用。
- 老设备:只认网址,遇到
WIFI:开头的内容按无效处理,需要第三方扫码 App。 - 企业管控设备:相机扫码常被策略禁用,这类场合必须同时提供文字版网络信息。
五、自查:把码解出来看一眼
- 用任意扫码 App(不是相机)扫你导出的图。
- 确认开头是
WIFI:,四个字段齐全。 - 确认结尾是两个分号。
- 逐字比对 SSID 与密码,尤其是含空格、中文、特殊符号的部分。
- 确认没有多出来的空格(例如
S: Cafe里的前导空格会成为网络名的一部分)。
相关阅读
格式对了还要印得出来:尺寸、材质与反光怎么处理,见 WiFi 二维码打印指南;SSID、BSSID 这些缩写不确定含义时先看 术语表。
常见问题
WiFi 二维码的内容是什么格式?
为什么密码里的分号必须转义?
开放网络怎么写?
WPA3 或企业级网络支持吗?
这张海报,可以套这些模板
按本文场景挑的 3 套版式,改掉场所名和密码就能直接导出。