Wi-Fi 二维码：确切格式，以及客人怎么扫
Wi-Fi 二维码就是一个普通二维码，只是它的内容是一行固定格式的文本：WIFI:T:WPA;S:mynetwork;P:mypass;;。按照 ZXing 项目 wiki 的说明，这行文本里 T 是安全类型，S 是网络名称，P 是密码。Google 的 Pixel 帮助说，扫描二维码可以让你连上 Wi-Fi 网络，所以客人不用手输密码就能上网。
下面依次讲：主要字段、各方资料不一致的两处（WPA3 和特殊字符）、怎么生成码，以及 iPhone 和安卓的扫码步骤。
事实核查于 2026 年 10 月 17 日。
Wi-Fi 二维码里存的是什么
有两份技术文档描述了这行文本：ZXing wiki，以及安卓开源项目（AOSP）设置应用的 Wi-Fi 二维码类，后者使用同样的示例文本，并定义了允许的安全类型取值。IANA 收录了一个临时的 wifi URI 方案，于 2020 年登记，引用了 Wi-Fi 联盟 WPA3 规范的第 7 节，并说明它向后兼容「事实标准格式」。这里无法核实规范原文，所以下面的字段取值来自 ZXing 和安卓。
| 部分 | 含义 | 资料怎么说 |
|---|---|---|
WIFI: | 表明内容是 Wi-Fi 设置的前缀 | 两个示例都以它开头 |
T: | 安全类型 | ZXing 列出 WEP、WPA、WPA2-EAP 和 nopass。安卓代码定义了 nopass、WEP、WPA 和 SAE |
S: | 网络名称（SSID） | 必填 |
P: | 密码 | T 为 nopass 时会被忽略，这时可以省略 |
H: | 隐藏网络 | 可选；网络名称隐藏时填 true |
;; | 文本结尾 | 示例以两个分号结尾 |
用这些字段拼出的一个隐藏 WPA 网络是这样的：WIFI:T:WPA;S:CafeGuest;P:example-pass;H:true;;。两份资料的字段顺序不同：安卓的网络配置代码依次写 S、T、P、H，而 ZXing 的示例以 T 开头。ZXing wiki 说字段顺序无关紧要。
P: 字段以明文保存密码，所以任何人解码这个码都能读到它。免费的二维码识别工具能解码二维码的照片或截图，显示完整的文本，并标注它是一个 Wi-Fi 网络，是快速查看一个码里到底存了什么的好办法。把印好的码放在你愿意直接贴出密码的地方。
各方资料不一致的地方：WPA3 和特殊字符
WPA3 与 T 的取值。 根据安卓文档，WPA3-Personal 使用对等实体同时验证（SAE）取代预共享密钥，文档还说安卓从 10 版起支持 WPA3。在二维码文本里，ZXing wiki 没有列出 SAE，而安卓代码在 WPA 旁边定义了 SECURITY_SAE = "SAE"。供应用开发者使用的 Google ML Kit 条码 API 只列出开放、WPA 和 WEP 几种类型；不过那描述的是 API，不是手机的相机应用。这些页面都没有说明某个相机应用对 WPA3 网络接受哪个取值。不要以为 T:SAE 能从安卓照搬到 iPhone 上，任何 WPA3 的码在印刷前都要在两个平台上测试。
特殊字符。 ZXing wiki 说，\、;、,、" 和 : 这几个字符要用反斜杠转义。同一份配置代码里，安卓的转义函数会转义反斜杠、逗号、分号和冒号，而这里读到的版本不转义双引号。两份资料在这一个字符上有分歧。如果网络名称和密码由你决定，干脆别用这些字符，问题就不存在了。如果不由你决定，就打印一份测试样，在两个平台上都扫一扫。
看起来像十六进制的名称。 对于可能被当成十六进制读取的 ASCII 名称或密码，ZXing wiki 给的示例是用双引号包起来的 "ABCD"。这样的名称，印刷前先测试。
五步生成二维码
- 复制信息。 按路由器显示的原样复制网络名称和密码，包括大小写、空格和标点。
- 选择 Wi-Fi 类型。 在二维码生成器里，QR Maker AI 的 Wi-Fi 内容类型提供 WPA/WPA2、WEP 和无密码，外加一个隐藏网络选项。没有单独的 WPA3 选项，所以按上面的建议处理并测试。
- 下载图片。 Wi-Fi 码是静态码：信息就在图案里，不需要账户，导出 PNG 免费。
- 检查文本和设计。 拍一张码的照片，先用识别工具解码，再用可扫性检查检查。检查的评分只针对设计本身，无法判断纸张、墨水或灯光。用尺寸计算器选定印刷宽度。
- 扫一份印出来的测试样。 在印牌子之前，按实际尺寸打印一份，用一部 iPhone 和一部安卓手机扫。如果有一部失败，扫不出来的二维码这篇列出了常见原因。
只有网址类的码能做成动态码，所以 Wi-Fi 码永远是静态码。密码一改，印好的牌子就错了，唯一的办法是用新码做一块新牌子。单独设一个很少改密码的访客网络，能让牌子有效得更久。摆放位置可以参考酒店使用场景，两种码的区别见动态码还是静态码。
客人怎么扫
iPhone
- 从主屏幕、锁定屏幕或控制中心打开「相机」应用。也可以打开控制中心，轻点「扫描代码」（Scan Code）。Apple 支持介绍了这两种方式。
- 拿稳手机，让整个码都在画面里。
- 等出现横幅后轻点它。在一场关于 iOS 11 二维码识别的 Apple 开发者讲座里，Apple 说 Wi-Fi 码会显示一个横幅，轻点后会提示用户加入网络。那个页面没有日期，讲的是旧版本，而 Apple 现在介绍扫码的页面没有提到 Wi-Fi，所以具体文字请以你自己手机上显示的为准。
如果找不到「扫描代码」，就按住控制中心的空白处，轻点「添加控制」（Add a Control），再轻点「扫描代码」。
安卓
- 打开「相机」应用，在设置的「更多设置」里打开「相机扫描建议」（Camera scan suggestions）。
- 把相机对准二维码，让整个码都在屏幕上。不需要拍照。
- 等出现气泡或链接后轻点它。根据同一个 Pixel 帮助页面，也可以用 Google 智能镜头（Google Lens）。
这些是 Google 为 Pixel 手机给出的步骤。这里没有涉及其他厂商的相机应用，而且 Pixel 页面没有专门针对 Wi-Fi 的步骤，所以轻点后的提示可能长得不一样。
已连接的 Pixel 手机也能显示一个码：打开「设置」，依次进入「网络和互联网」（Network & internet）、「互联网」（Internet），轻点网络旁的设置图标，再轻点「分享」（Share），如有要求则验证身份。Google 的 Wi-Fi 帮助说，其中有些步骤只适用于安卓 11 及以上版本。
手机没有提示连接时
| 你看到的情况 | 可能原因 | 怎么办 |
|---|---|---|
| 相机没显示有用的信息，或者只显示一段文字 | 码里存的不是以 WIFI: 开头的文本 | 用识别工具解码，把文本和上面的表格对照 |
| 手机提示加入，但连接失败 | 密码输错，或者某个特殊字符的转义方式不同 | 重新复制密码，尽量避免使用 \ ; , " : |
| WPA3 网络连接失败 | 可能的原因之一是 T 的取值，资料在这里有分歧 | 在一部 iPhone 和一部安卓手机上测试 T:WPA。如果你按安卓代码里的 T:SAE 手写文本，也要在两个平台上测试 |
| 隐藏网络连接失败 | H:true 是格式的一部分。Apple 的 iOS 11 讲座说那个版本不支持隐藏 SSID，而这里读到的页面没有描述现在的手机 | 在两个平台上测试，并在码旁边印上可手输的信息 |
| 码完全扫不出来 | 尺寸、对比度或空白边框的问题 | 用可扫性检查和尺寸计算器 |
在码旁边用文字印出网络名称和密码。相机应用读不了这个码的客人，就能手动输入。
常见问题
Wi-Fi 二维码是什么格式？
是一行文本，比如 WIFI:T:WPA;S:mynetwork;P:mypass;;，其中 T 是安全类型，S 是网络名称，P 是密码，可选的 H:true 表示隐藏网络。
能给 WPA3 网络做二维码吗？
ZXing 列出了 WPA，没有 SAE；而安卓代码还定义了 SAE。两个页面都没有说明各相机应用对 WPA3 接受什么，所以要在一部 iPhone 和一部安卓手机上测试。QR Maker AI 的生成器提供 WPA/WPA2、WEP 和无密码，第一项写入的是 T:WPA；它没有单独的 WPA3 选项。
Wi-Fi 二维码适用于隐藏网络吗？
格式里有 H:true 字段。Apple 的 iOS 11 讲座说那个版本不支持隐藏 SSID，而为本文查阅的页面都没有说明现在的手机相机怎么处理。在两个平台上测试，并在码旁边印上可手输的信息。
能不重印二维码就改 Wi-Fi 密码吗？
不能。Wi-Fi 码是静态码，密码就在图案里。生成一个新码，替换掉印好的那个。
别人能从码里读出密码吗？
P: 字段就是原样写入的密码，所以任何二维码识别工具都能显示它。把印好的码当作密码本身来对待。
参考来源
- ZXing project — Barcode Contents (Wi-Fi Network config). Page shows last edit 16 October 2026. Accessed 17 October 2026.
- Google — Scan QR codes with your Pixel phone. Undated. Accessed 17 October 2026.
- Android Open Source Project — WifiQrCode.java (Settings app, main branch). Undated. Accessed 17 October 2026.
- IANA — Provisional URI scheme: wifi. Registered 26 August 2020; last updated 15 December 2020. Accessed 17 October 2026.
- Android Open Source Project — WifiNetworkConfig.java (Settings app, main branch). Undated. Accessed 17 October 2026.
- Android Open Source Project — WPA3 and Wi-Fi Enhanced Open. Last updated 9 October 2026. Accessed 17 October 2026.
- Google — Barcode.WiFi, ML Kit reference. Last updated 31 October 2024. Accessed 17 October 2026.
- Apple — Scan a QR code with your iPhone or iPad. Page date not cited. Accessed 17 October 2026.
- Apple — QR Code Recognition on iOS 11 (Tech Talk). Undated. Accessed 17 October 2026.
- Google — Connect to Wi-Fi networks on your Pixel phone. Undated. Accessed 17 October 2026.