CodeToolProCodeToolProFree Online Developer Tools
GitHub

WiFi QR Code Generator

技术详情

Wi-Fi 二维码生成器的工作原理

工具功能

Wi-Fi 二维码生成器将 Wi-Fi 连接信息编码为标准格式的二维码。输入 Wi-Fi 的 SSID(网络名称)、加密类型(WPA/WPA2/WEP/nopass)和密码后,工具生成 WIFI: 格式的 URI 字符串——这是一个非正式的业界标准,然后将其编码为 QR 码。智能手机(iOS 11+ 和 Android 10+)的相机和 QR 码扫描应用识别此格式后会自动弹出 Wi-Fi 连接提示。可保存 PNG 或 SVG 格式用于打印展示。


常见开发者使用场景

Wi-Fi 二维码在智能家居、商业场所和开发场景中实用。智能家居产品(如智能灯泡、IoT 传感器)配网时扫描 Wi-Fi 二维码自动填写网络信息。咖啡店、酒店、联合办公空间打印 Wi-Fi 二维码方便客人连接,避免手写 SSID 和密码的不便。开发智能设备 App 的配网流程(如 ESP32/ESP8266 配网)时,Wi-Fi 二维码是快速绑定方案。家庭中为来访朋友提供 Wi-Fi 连接方式也是生活场景。

配合 二维码生成器 了解更通用的 QR 码生成功能,或使用 密码生成器 创建安全的 Wi-Fi 密码。


Wi-Fi QR Code 格式规范

Wi-Fi 二维码使用的 URI 格式(非 IETF 标准,但已广为支持):

  • 基本格式:WIFI:S:<SSID>;T:<WPA|WEP|nopass>;P:<密码>;H:<true|false>;;
  • S(SSID):Wi-Fi 网络名称,支持中文需用双引号包裹。注意:SSID 区分大小写。
  • T(类型):WPA(适用于 WPA/WPA2/WPA3 混合模式)、WEP(不推荐使用)、nopass(开放网络)
  • P(密码):Wi-Fi 密码。对于开放网络(T:nopass),该字段留空。
  • H(隐藏网络):H:true 表示隐藏 SSID(不广播),默认为 false。隐藏网络的连接成功率较低,不推荐。

常见陷阱与注意事项

  • 特殊字符:SSID 或密码中包含 ;(分号)、,(逗号)、:(冒号)和 \(反斜杠)需要转义——这些字符在 URI 中有特殊含义。前置反斜杠转义:\,、\;、\:、\\。
  • 加密类型选择:T:WPA 是一个通用选项,同时覆盖 WPA/WPA2/WPA3 所有版本。不需要区分 WPA2 和 WPA3,iOS/Android 会自动协商。
  • 隐私注意:打印的 Wi-Fi QR 码包含明文密码,任何人扫描即可连接。公开场所建议使用 Captive Portal 而非直接共享密码。
  • 企业网络(WPA2-Enterprise):Wi-Fi QR 码标准不支持使用用户名+密码的企业认证——仅支持 PSK(预共享密钥)模式。

何时使用此工具而非代码

在为智能家居产品、商业空间或家庭 Wi-Fi 创建分享二维码时使用此工具。对于需要在 app 中动态生成 Wi-Fi 二维码的场景,使用各自的 QR 码库(如 Android 的 ZXing、iOS 的 CoreImage + CIQRCodeGenerator)。