WiFi 二维码到底是怎么扫一下就连上网的

你大概在咖啡馆柜台、民宿门口或者朋友家冰箱上见过这种码:掏出手机相机对一下,屏幕弹出"加入网络",点一下就连上了,全程没人念过一个字母的密码。它看起来像魔法,其实背后只是一段约定好格式的纯文本。理解了这段文本,你就知道为什么有的码扫了连不上,也知道给店铺访客网络做一张靠谱的码该注意什么。

一段文本,不是一张图

很多人以为二维码里"藏"着网络。其实不是。WiFi 二维码里编码的,就是一串符合 Wi-Fi Alliance 约定的纯文本。手机相机解出这串文本后,识别出它以 WIFI: 开头,于是不把它当网址打开,而是弹出连接网络的提示。

这串文本的格式是这样:

WIFI:T:WPA;S:网络名称;P:密码;H:false;;

拆开看每个字段:

T: 是加密类型,取值 WPA、WEP 或 nopass(开放网络);
S: 是 SSID,也就是网络名称;
P: 是密码,开放网络这里留空;
H: 是隐藏网络标记,true 表示路由器不广播 SSID,手机需要主动去搜;
字段之间用 ; 分隔,整串以 ;; 结尾。

手机读到这五个字段,就等于拿到了连接一个 WiFi 所需的全部信息:连哪个网、用什么加密、密码是什么。所以二维码本身没有任何"智能",它只是把你本来要口头念的那几样东西,换成了一张机器能一眼读完的图。

一个真实的字符串例子

假设你的网络名叫 Cafe Luna,密码是 be;ans:2026,加密是 WPA2。注意这个密码里有 ; 和 :,而它们恰好是字段分隔符。如果直接拼进去,扫码器会把 be 当成密码、把 ans 当成新字段,整串就断了。

正确的做法是给保留字符加反斜杠转义。WiFi 二维码格式里有五个保留字符:\ ; , : "。转义之后,这个网络的完整字符串是:

WIFI:T:WPA;S:Cafe Luna;P:be\;ans\:2026;H:false;;

可以看到密码里的 ; 变成了 \;,: 变成了 \:。扫码器还原时会把反斜杠脱掉,得到字面密码 be;ans:2026,于是连接成功。手动拼这串最容易栽在这一步,所以用 WiFi 二维码生成器时直接粘贴原始密码就行,转义它会自动、且只做一次。

加密类型怎么选,这是连不上的头号原因

加密类型必须和路由器完全一致,选错就扫得出却连不上。这里有个反直觉的点:WPA、WPA2、WPA3 家庭版在二维码格式里共用同一个类型码 WPA,并没有单独的 WPA3 标记。所以无论你的路由器是 WPA2 还是 WPA3,选 WPA / WPA2 / WPA3 都是对的,不用纠结。

真正会出问题的是另外两种:给开放网络误填了密码,以及给现代路由器选了老旧的 WEP。开放网络的类型码是 nopass,密码字段必须留空,这时候多塞一个密码反而会让连接失败。WEP 只在很老的设备上还能见到,现在几乎不用了。家用或办公路由器拿不准时,选 WPA / WPA2 / WPA3 基本不会错。

店铺、民宿、访客网络:它真正解决的麻烦

我自己第一次给家里做这码,是因为受够了每来一个朋友就要把那串 16 位密码念一遍,还总有人问"那个是大写 O 还是数字 0"。打印一张贴冰箱上之后,这事彻底消失了,亲戚来了自己扫,十秒搞定。

放到生意场景里,这个收益被放大了很多倍:

咖啡馆柜台:一个班次不用再回答四十遍"密码是多少"。印成 A6 卡过塑,放在客人坐下后一臂能够到的位置,因为手机从柜台走到座位多半已经锁屏。
民宿短租:客人一进门扫一下就连上,行李还没放下。导出 SVG 放进带框的欢迎卡,印刷放大也不糊,容错档选 Q,卡片被反复翻动留点污渍也还能扫。
办公室前台访客网络:如果访客网络是故意不广播的,勾上"隐藏网络",生成的串就会带 H:true,手机会主动去搜。

打印有几条经验值得记:打印尺寸不小于 3 cm 见方,保持黑底白码(彩色底会明显降低识别率),过塑或装框前先在一臂距离扫一下测试。容错等级室内清洁打印用 M 就够,贴在金属架上可能被揉皱淋雨的场景用 H,它能恢复最高约 30% 的污损。

二维码本身就是密码,请这样保管

这里有个安全直觉容易被忽略:生成出来的二维码图,本质上就是你密码的可视化形式。任何人只要拍下这张印出来的码并解码,就能连上你的网络。所以你可以反向用这一点验证一张码对不对,把它丢进二维码解码器解出来,看 WIFI: 字符串里的字段是不是你预期的。但也正因如此,这张码要当成密码本身来对待:换了密码记得重印,旧的那张就自动失效了,这恰恰是想要的效果。

好工具会替你守住真正的秘密。密码这一项只存在页面内存里,不写进可分享的 URL,不存 localStorage,也不上传,二维码完全在浏览器里生成。换句话说,你复制的"分享这套配置"链接里只有网络名称和加密类型,没有密码。如果你需要给访客网络配一个高强度密码,可以先用密码生成器生成,再丢进 WiFi 二维码生成器,流程一气呵成。

理解了 WIFI: 这段文本,你就不再是"碰运气扫码",而是真正知道每个字段在做什么。下次再看到柜台上那张小卡,你能一眼说出它编码的是哪个网、什么加密、密码有没有藏好。

Made by Toolora · Updated 2026-06-13