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 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)。