WiFi 二维码格式详解

那段以 WIFI: 开头的纯文本,是整个扫码连网流程里唯一真正重要的东西。写错一个分号,手机上就什么都不会发生。

二维码本身只是容器,真正决定能不能连网的是里面的字符串。这套格式没有 ISO 标准号,是由安卓与 iOS 共同沿用、逐步固定下来的事实约定。也正因为它是约定而非标准,各家解析器的容错程度并不一致,写的时候需要按最严格的那种来要求自己。

一、基本结构

WIFI:T:WPA;S:MyNetwork;P:MyPassword;H:false;;
字段含义取值是否必填
T加密方式WPA / WEP / nopass建议始终填写
SSSID,网络名称任意字符串,区分大小写必填
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 与安卓的解析差异

五、自查:把码解出来看一眼

  1. 用任意扫码 App(不是相机)扫你导出的图。
  2. 确认开头是 WIFI:,四个字段齐全。
  3. 确认结尾是两个分号。
  4. 逐字比对 SSID 与密码,尤其是含空格、中文、特殊符号的部分。
  5. 确认没有多出来的空格(例如 S: Cafe 里的前导空格会成为网络名的一部分)。

不想手写这段字符串?

在设计器里填名称与密码,转义、终止符、隐藏网络标记都由程序处理,导出后可直接扫。

打开 WiFi 二维码设计器

相关阅读

格式对了还要印得出来:尺寸、材质与反光怎么处理,见 WiFi 二维码打印指南;SSID、BSSID 这些缩写不确定含义时先看 术语表。

常见问题

WiFi 二维码的内容是什么格式?
是一段纯文本,形如 WIFI:T:WPA;S:网络名;P:密码;H:false;;,用分号分隔字段、双分号结尾。iOS 与安卓都按这套约定解析,它没有官方标准号,但已成为事实通用格式。
为什么密码里的分号必须转义?
分号是字段分隔符。密码中出现未转义的分号时,解析器会把后半段当作下一个字段,导致密码被截断或字段错位。反斜杠、逗号、冒号与双引号同理,都要加反斜杠。
开放网络怎么写?
把 T 设为 nopass,P 留空,例如 WIFI:T:nopass;S:Cafe-Guest;;。如果写成 WPA 而不带密码,手机通常会连接失败。
WPA3 或企业级网络支持吗?
WPA3 个人版沿用 WPA 写法,实践中可正常连接。企业级 802.1X 需要账号与证书,超出该格式能表达的范围,只能用自定义链接指向上网指引页。

这张海报,可以套这些模板

按本文场景挑的 3 套版式,改掉场所名和密码就能直接导出。