WiFi QR Wi-Fi 二維碼連不上？格式、特殊符號與隱藏網路
一張掃得到卻連不上的 Wi-Fi 二維碼，幾乎都是某個細節出錯：密碼或名稱跟路由器不完全一致、安全類型選錯、某個特殊符號沒有轉義，或是網路本身是隱藏的而二維碼沒有標示。先掃一次看看碼裡實際寫了什麼，修正那個細節後再重新製作一張。
檢查清單：為什麼 Wi-Fi 二維碼連不上
- 製作二維碼之後，路由器上的密碼又被改過。二維碼不會自己更新。
- 名稱或密碼沒有完全對上：大小寫、空格和符號都算數。
- 安全類型選錯，例如一個有密碼的網路卻標成開放。
- 名稱或密碼裡的 ; , : \ 或 " 沒有被轉義，導致手機讀到被截斷的密碼。
- 名稱或密碼看起來像十六進位數字卻沒有加引號，讓某些手機把它當成位元組來讀。
- 網路是隱藏的，但二維碼沒有帶上隱藏旗標。
- 網路是企業型（帳號加密碼），這種二維碼本身無法承載。
- 手機超出訊號範圍，或網路只有 5 GHz 而裝置只支援 2.4 GHz。
用 WiFi QR 找出問題所在
- 打開掃描分頁，掃那張連不上的二維碼。掃描網絡視窗會顯示裡面的名稱、安全類型和密碼。
- 逐字跟路由器上的資料比對，點眼睛圖示可以顯示密碼。
- 在產生分頁輸入正確資料。如果按鈕下方出現紅字訊息，先照它說的修正，二維碼在資料正確之前不會畫出來。
- 如果網路是隱藏的，打開進階選項並開啟隱藏網絡。
- 用一支還沒連過這個網路的手機測試新二維碼，確認沒問題後再取代舊的。
錯誤訊息代表什麼
| 訊息 | 為什麼重要 | 解法 |
|---|---|---|
| 網路名稱不能超過32個字符 | Wi-Fi 名稱限制為 32 位元組，過長的名稱對不上任何網路。 | 用路由器上顯示的完整名稱，重音符號和表情符號每個都占好幾個位元組。 |
| 安全網路需要密碼 | WPA 或 WEP 網路沒有金鑰就無法加入。 | 輸入密碼，或如果真的沒有密碼就選開啟（無密碼）。 |
| WPA密碼必須在8到63個字元之間 | 超出這個範圍的 WPA 金鑰，任何手機都會拒絕。 | 檢查密碼，像 abc1234 這種 7 個字元的密碼通常是打錯或不完整。 |
| WEP密鑰必須是5或13個字符，或10或26個十六進位數字 | 這是 WEP 金鑰僅有的幾種合法長度。 | 檢查金鑰，或把路由器改成 WPA2 或 WPA3。 |
名稱長度限制是以位元組計算，不是字元數。「Café Wi-Fi ☕ Terrazza Grande」有 28 個字元、31 個位元組，所以能通過；加上「 2」變成 30 個字元卻有 33 個位元組，就會太長，因為 é 和 ☕ 每個都占超過一個位元組。
Wi-Fi 二維碼的文字格式
Wi-Fi 二維碼其實是純文字：WIFI:T:type;S:name;P:password;H:true;;，每個小寫單字代表一個欄位。T 是 WPA、WEP，或開放網路用的 nopass。開放網路會省略 P。H:true 只在隱藏網路時出現。文字最後以兩個分號結束。
在每個值裡面，\ ; , : 和 " 這幾個字元前面都會加反斜線。而當某個值恰好是偶數個十六進位數字（0-9、a-f）時，WiFi QR 會把它用雙引號包起來，讓手機當成文字讀取。以下是 app 在不同情況下實際寫出的內容：
| 情況 | 名稱／密碼 | 二維碼裡的文字 |
|---|---|---|
| 密碼含冒號和分號 | Casa Rossi / sole;mare:2024 | WIFI:T:WPA;S:Casa Rossi;P:sole\;mare\:2024;; |
| 名稱含逗號，密碼含引號 | Casa, Rossi / Sole"Mare88 | WIFI:T:WPA;S:Casa\, Rossi;P:Sole\"Mare88;; |
| 密碼看起來像十六進位 | HomeNet / 1234abcd | WIFI:T:WPA;S:HomeNet;P:"1234abcd";; |
| 名稱看起來像十六進位 | CAFE2024 / espresso-bar | WIFI:T:WPA;S:"CAFE2024";P:espresso-bar;; |
| 隱藏網路 | Office-5G / Blue+Sky7 | WIFI:T:WPA;S:Office-5G;P:Blue+Sky7;H:true;; |
| 開放網路 | Cafe Guest / 沒有密碼 | WIFI:T:nopass;S:Cafe Guest;; |
| WEP 十六進位金鑰 | Old / A1B2C3D4E5 | WIFI:T:WEP;S:Old;P:"A1B2C3D4E5";; |
隱藏 SSID 與 WPA3
隱藏網路要開啟隱藏網絡，讓二維碼帶上 H:true；手機即使沒看到廣播，也會主動搜尋這個網路。WPA3-Personal 選WPA/WPA2/WPA3即可，碼裡會寫 T:WPA，手機用同一套資料對應 WPA2 和 WPA3，包括混合模式的 WPA2/WPA3 路由器。
Wi-Fi 二維碼只在 iPhone 上連不上？
如果 Android 手機能連但 iPhone 不能，打開相機 app，確認二維碼完整落在畫面裡，等黃色橫幅出現後再點它。如果這支 iPhone 之前用舊密碼存過這個網路，先到 iOS 設定的 Wi-Fi 頁面忘記這個網路，再重新掃描。
常見問題
Wi-Fi 二維碼放久了會失效嗎？
不會。二維碼裡的網路名稱和密碼是固定文字，內容永遠不會自己變。只有路由器上的密碼或名稱改變時，它才會失效。
Wi-Fi 二維碼支援 WPA3 嗎？
支援 WPA3-Personal：碼裡寫的是 T:WPA，手機會拿它同時對應 WPA2 和 WPA3。在 WiFi QR 裡選WPA/WPA2/WPA3即可。需要帳號的 WPA3-Enterprise 不支援。
Wi-Fi 二維碼能連上隱藏網路嗎？
可以，只要碼裡帶有 H:true。在 WiFi QR 的進階選項裡開啟隱藏網絡，並確實輸入正確的名稱。
為什麼密碼裡有分號會讓二維碼壞掉？
分號在 Wi-Fi 二維碼格式裡用來分隔欄位，沒有轉義的分號會讓密碼提早截斷。WiFi QR 會自動幫你加上反斜線。