Wi-Fi QR Code：確切格式，以及客人怎麼掃
Wi-Fi QR Code 就是一個普通 QR Code，只是它的內容是一行固定格式的文本：WIFI:T:WPA;S:mynetwork;P:mypass;;。按照 ZXing 專案 wiki 的說明，這行文本里 T 是安全型別，S 是網路名稱，P 是密碼。Google 的 Pixel 幫助說，掃描 QR Code 可以讓你連上 Wi-Fi 網路，所以客人不用手輸密碼就能上網。
下面依次講：主要欄位、各方資料不一致的兩處（WPA3 和特殊字元）、怎麼生成碼，以及 iPhone 和安卓的掃描步驟。
事實核查於 2026 年 10 月 17 日。
Wi-Fi QR Code 裡存的是什麼
有兩份技術文件描述了這行文本：ZXing wiki，以及安卓開源專案（AOSP）設定應用的 Wi-Fi QR Code 類，後者使用同樣的示例文本，並定義了允許的安全型別取值。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: 欄位以明文儲存密碼，所以任何人解碼這個碼都能讀到它。免費的QR Code 識別工具能解碼 QR Code 的照片或截圖，顯示完整的文本，並標註它是一個 Wi-Fi 網路，是快速檢視一個碼裡到底存了什麼的好辦法。把印好的碼放在你願意直接貼出密碼的地方。
各方資料不一致的地方：WPA3 和特殊字元
WPA3 與 T 的取值。 根據安卓文件，WPA3-Personal 使用對等實體同時驗證（SAE）取代預共享金鑰，文件還說安卓從 10 版起支援 WPA3。在 QR Code 文本里，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"。這樣的名稱，印刷前先測試。
五步生成 QR Code
- 複製資訊。 按路由器顯示的原樣複製網路名稱和密碼，包括大小寫、空格和標點。
- 選擇 Wi-Fi 型別。 在QR Code 生成器裡，QR Maker AI 的 Wi-Fi 內容型別提供 WPA/WPA2、WEP 和無密碼，外加一個隱藏網路選項。沒有單獨的 WPA3 選項，所以按上面的建議處理並測試。
- 下載圖片。 Wi-Fi 碼是靜態碼：資訊就在圖案裡，不需要帳戶，匯出 PNG 免費。
- 檢查文本和設計。 拍一張碼的照片，先用識別工具解碼，再用可掃性檢查檢查。檢查的評分只針對設計本身，無法判斷紙張、墨水或燈光。用尺寸計算器選定印刷寬度。
- 掃一份印出來的測試樣。 在印牌子之前，按實際尺寸列印一份，用一部 iPhone 和一部安卓手機掃。如果有一部失敗，掃不出來的 QR Code這篇列出了常見原因。
只有網址類的碼能做成動態碼，所以 Wi-Fi 碼永遠是靜態碼。密碼一改，印好的牌子就錯了，唯一的辦法是用新碼做一塊新牌子。單獨設一個很少改密碼的訪客網路，能讓牌子有效得更久。擺放位置可以參考飯店使用場景，兩種碼的區別見動態碼還是靜態碼。
客人怎麼掃
iPhone
- 從主螢幕、鎖定螢幕或控制中心開啟「相機」應用。也可以開啟控制中心，輕點「掃描程式碼」（Scan Code）。Apple 支援介紹了這兩種方式。
- 拿穩手機，讓整個碼都在畫面裡。
- 等出現橫幅後輕點它。在一場關於 iOS 11 QR Code 識別的 Apple 開發者講座裡，Apple 說 Wi-Fi 碼會顯示一個橫幅，輕點後會提示使用者加入網路。那個頁面沒有日期，講的是舊版本，而 Apple 現在介紹掃描的頁面沒有提到 Wi-Fi，所以具體文字請以你自己手機上顯示的為準。
如果找不到「掃描程式碼」，就按住控制中心的空白處，輕點「新增控制」（Add a Control），再輕點「掃描程式碼」。
安卓
- 開啟「相機」應用，在設定的「更多設定」裡開啟「相機掃描建議」（Camera scan suggestions）。
- 把相機對準 QR Code，讓整個碼都在螢幕上。不需要拍照。
- 等出現氣泡或連結後輕點它。根據同一個 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 QR Code 是什麼格式？
是一行文本，比如 WIFI:T:WPA;S:mynetwork;P:mypass;;，其中 T 是安全型別，S 是網路名稱，P 是密碼，可選的 H:true 表示隱藏網路。
能給 WPA3 網路做 QR Code 嗎？
ZXing 列出了 WPA，沒有 SAE；而安卓程式碼還定義了 SAE。兩個頁面都沒有說明各相機應用對 WPA3 接受什麼，所以要在一部 iPhone 和一部安卓手機上測試。QR Maker AI 的生成器提供 WPA/WPA2、WEP 和無密碼，第一項寫入的是 T:WPA；它沒有單獨的 WPA3 選項。
Wi-Fi QR Code 適用於隱藏網路嗎？
格式裡有 H:true 欄位。Apple 的 iOS 11 講座說那個版本不支援隱藏 SSID，而為本文查閱的頁面都沒有說明現在的手機相機怎麼處理。在兩個平臺上測試，並在碼旁邊印上可手輸的資訊。
能不重印 QR Code 就改 Wi-Fi 密碼嗎？
不能。Wi-Fi 碼是靜態碼，密碼就在圖案裡。生成一個新碼，替換掉印好的那個。
別人能從碼裡讀出密碼嗎？
P: 欄位就是原樣寫入的密碼，所以任何 QR Code 識別工具都能顯示它。把印好的碼當作密碼本身來對待。
參考來源
- 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.