症狀：Visual Studio 看得到或找不到 Mac，但 Pair to Mac 一直失敗，甚至已顯示連線卻不能建置 iOS。
最快解法：不要先重裝 Visual Studio 或 Xcode；先確認普通 SSH，再依序檢查 Pair to Mac 認證、自動設定，最後核對 Xcode 與 .NET MAUI 的相容性。
這篇適合三類讀者：只有 Windows 電腦、第一次用 Pair to Mac 交 iOS 作業的學生；看得到遠端 Mac、輸入正確帳號仍無法連線的新手；以及已顯示連線成功，卻沒有 iOS 執行目標或持續建置失敗的學習者。
SECTION 01先把失敗分在哪一層
Pair to Mac 不是單一按鈕，而是一條由多個環節組成的通道。你可以把它想成進教室：SSH 是校門與門禁，Pair to Mac 是登記座位，自動設定是在桌上放好工具，Xcode 與 .NET MAUI SDK 則是實際上課需要的工具箱。
請先記下三件事：
- 原始錯誤訊息，不要只截取最後一行。
- 錯誤發生在找主機、輸入帳號、配對、下載工具，還是按下建置之後。
- 最近是否更換過密碼、Mac、Xcode、Visual Studio 或 .NET MAUI 工作負載。
官方流程的基本前提是：Windows 上的 .NET MAUI iOS 建置，需要連到一台網路可達的 Mac；Pair to Mac 會透過 SSH 發現、驗證並記住這台建置主機。Microsoft 的 Pair to Mac 官方流程也將主機連線與後續建置分開處理。
因此，先按以下分支決定下一步：
- 若普通 SSH 完全無法登入：先處理主機可達性、遠端登入權限或帳號問題，不要反覆按 Pair to Mac。
- 若 SSH 可以登入，但 Pair to Mac 失敗：檢查 Visual Studio 使用的帳號、密碼、SSH 金鑰與主機身分記錄。
- 若配對成功但自動設定循環：檢查遠端 Mac 的權限、可用儲存空間與工具下載或寫入階段。
- 若已連線但不能建置：停止折騰網路，改查 Xcode、.NET MAUI 工作負載、SDK、專案目標與簽署設定。
SECTION 02找不到遠端 Mac，先處理可達性而不是關防火牆
如果 Pair to Mac 清單沒有出現主機，可能只是自動發現失敗，不代表 Mac 不存在或一定離線。學校網路、不同子網路、VPN、路由器隔離，都可能讓自動發現看不到主機。
第一步，確認遠端 Mac 本身已開機，而且 Windows 電腦能使用正確的主機位址。第二步，在 Mac 的系統設定中確認「遠端登入」已啟用，並確認目前使用的 macOS 帳號被允許透過 SSH 登入。第三步，回到 Visual Studio，依官方流程手動輸入 Mac 的主機名稱或 IP 位址，而不是只等待清單自動填入。
這裡的低風險驗收標準是：你能取得正確主機位址，遠端 Mac 有允許登入的使用者，且學校或公司網路沒有禁止這類連線。若手動加入後仍完全無法建立 SSH，應把問題交給環境管理員，或改用另一台權限完整、網路可達的真實 Mac。
提醒： 不要為了讓主機「被發現」而停用防火牆、公開不必要的連接埠、繞過校園網路管理，或執行來源不明的修復腳本。這些動作不能證明 Pair to Mac 已經正確，反而會留下安全與帳號風險。
如果你只是缺少可用的 macOS 主機，可以先閱讀 Windows 遠端連線 Mac 的入門說明，確認自己需要的是教學環境、作業用建置主機，還是長期開發設備。
SECTION 03第一步：能用 SSH 登入，才開始查 Pair to Mac 帳號
Pair to Mac 密碼明明正確，仍然連線失敗，常見原因不一定是密碼本身。SSH 會同時確認教室地址、門禁帳號，以及你面前這把鑰匙是否屬於正確主機；其中任一項不符，Visual Studio 都可能只顯示籠統的驗證錯誤。
先在 Windows 使用系統內建 SSH，用遠端 Mac 的實際使用者名稱與主機位址測試：
ssh 使用者名稱@主機位址
不要把這個範例中的文字原樣輸入。你需要使用 Mac 上「使用者與群組」顯示的帳號短名稱，而不是電子郵件地址、顯示名稱或課程平台帳號。
測試時依序觀察：
- 要求輸入密碼後成功登入：基本網路、帳號與遠端登入權限大致正常，下一步查 Pair to Mac 的設定。
- 顯示 Permission denied：可能是帳號沒有遠端登入權限、密碼不屬於該 macOS 帳號，或 SSH 金鑰設定不匹配。
- 顯示主機身分變更：先停止操作，確認你連到的確實是那台 Mac，再由管理員處理主機身分記錄。
- 等待逾時或找不到主機：回到上一節查位址、路由、VPN 與網路隔離。
SSH 金鑰可以理解為不直接傳送密碼的鑰匙；主機身分記錄則像你第一次進教室時記住的門牌。兩者都不應透過共享密碼、共享私鑰或關閉主機校驗來「快速修好」。如果你沒有管理該 Mac 的權限，應請環境管理員重新確認遠端登入規則，而不是刪除所有安全檢查。
SECTION 04第二步：配對成功後，為什麼自動設定仍然失敗？
普通 SSH 能登入，不代表 Pair to Mac 已經完成。此時 Visual Studio 可能正在遠端 Mac 放置建置所需的工具，像是把 .NET MAUI 的工具箱搬進教室；下載中斷、權限不足、硬碟空間不足或舊元件殘留，都可能造成反覆設定。
請按照這個順序操作：
- 在 Visual Studio 中中斷目前的 Mac 配對，完整記錄錯誤訊息與發生時間。
- 使用 SSH 登入 Mac，確認目前帳號能在自己的家目錄建立與刪除測試檔案。
- 檢查 Mac 的可用儲存空間，並確認連線期間沒有進入睡眠或中斷網路。
- 回到 Visual Studio 的輸出或診斷記錄，找出是下載、解壓縮、寫入、啟動遠端工具，還是版本檢查失敗。
- 只針對記錄指向的階段處理，再重新配對，不要同時刪除整個使用者目錄或執行不明清理指令。
Microsoft 的 .NET MAUI 故障排查文件可用來對照輸出記錄；你應以「失敗發生在哪一步」判斷，而不是看到錯誤就重新安裝所有元件。
要特別分清楚一件事：Pair to Mac 可以協助準備部分遠端建置工具，但不能取代你在 Mac 上安裝並完成首次初始化的完整 Xcode。若 Mac 上沒有 Xcode，或 Xcode 從未開啟完成授權與初始化，配對即使顯示成功，iOS 建置仍可能失敗。這也是 .NET for iOS 的 Xcode 要求說明要求單獨檢查 Xcode 的原因。
SECTION 05第三步：連線成功，仍然不能建置 iOS 怎麼查？
「已連線」只代表 Windows 能找到並驗證建置主機，不等於整個 iOS 工具鏈相容。此時請不要再重試登入，改按以下順序核對。
先確認 Xcode 能獨立正常啟動
在遠端 Mac 直接開啟 Xcode，完成首次啟動所需的元件安裝與授權步驟。若 Xcode 本身要求額外元件、無法啟動，或 macOS 版本不符合該 Xcode 的系統要求，應先修正 Mac 環境。
Apple 的 Xcode 系統要求表會隨 Xcode 版本列出支援的 macOS 範圍。不要只看「Mac 上有 Xcode」這個條件；你要確認目前這台 Mac 的 macOS、Xcode 與課程指定的 .NET MAUI 工作負載能同時成立。
再確認 .NET MAUI 工作負載與 Xcode 對得上
在 Visual Studio 的安裝程式或工作負載管理位置，確認已安裝 .NET MAUI 相關工作負載；在 Mac 與 Windows 兩端，則以發布時的官方相容性說明核對 Xcode 與 .NET for iOS 的要求。具體對應關係可能隨 .NET MAUI 10、Xcode 或服務更新而變更，因此不要依照論壇舊截圖硬套。
最後確認專案目標與簽署
先選擇 iOS 模擬器目標，而不是一開始就連接實體 iPhone。確認專案的目標框架是 iOS，且 Visual Studio 使用的建置主機就是剛才完成配對的 Mac。若錯誤訊息提到 provisioning profile、憑證、Bundle Identifier 或裝置註冊，這已經是簽署問題，不是 Pair to Mac 連線問題；可依照 iOS 手動簽署設定文件處理。
另外，Visual Studio 2026 不支援 Hot Restart，官方方向是使用 Pair to Mac；因此不要把「沒有 Hot Restart」誤判成配對失敗，也不要期待 Hot Restart 代替完整的 Mac 建置流程。官方 Hot Restart 說明可作為功能邊界的核對依據。
SECTION 06第四步：用空白專案驗收，不要直接拿正式作業反覆嘗試
正式專案通常包含套件、簽署設定、原生相依性與自訂建置步驟。你需要一個可刪除的空白 .NET MAUI 專案，判斷故障在主機還是在作業本身。
照著以下流程操作：
- 備份正式專案與程式碼，然後建立新的空白 .NET MAUI 專案。
- 重新確認 Pair to Mac 顯示的主機是正確 Mac，並記下配對完成的訊息。
- 在遠端 Mac 確認 Xcode 已完成首次啟動，且目前帳號能使用必要的開發工具。
- 先選擇 iOS 模擬器目標，執行一次建置，再執行一次啟動。
- 觀察錯誤是在還原套件、編譯、啟動模擬器，還是簽署階段。
- 空白專案成功後，再逐項加入正式專案的套件與設定，不要一次貼回全部內容。
Microsoft 的 .NET MAUI iOS 部署流程與 iOS 命令列建置說明可用來確認建置階段。判斷結果很直接：
- 空白專案也不能建置：回到 Mac 權限、Xcode、工作負載與相容性檢查。
- 空白專案成功，正式專案失敗：回到正式專案的套件、目標框架、原生程式碼與簽署設定。
- 模擬器成功，實體裝置失敗：優先查 Apple 帳號、憑證、Provisioning Profile 與裝置註冊。
- 斷線後無法重連：先重新測試 SSH，再檢查 Pair to Mac 儲存的主機身分與帳號，不要直接清空整台 Mac。
如果你要使用遠端 Mac 完成課程作業，建議先閱讀 遠端 Mac 環境與租用週期的選擇指南，把「能否 SSH 登入、能否完成空白專案建置、是否符合課程 Xcode 要求」列為交付前驗收條件，而不是只看主機是否出現在清單。
SECTION 07什麼情況應該繼續修復，什麼情況應該更換環境？
若問題只出現在正式專案，而且空白專案已能完成建置，繼續修復原專案通常比較合理。若普通 SSH 都無法建立、你沒有遠端登入權限，或現有 Mac 的 Xcode 無法符合課程要求，繼續重裝 Visual Studio 不會解決根因。
你可以這樣決定：
- 有主機管理權限、SSH 正常、Xcode 可啟動：保留現有環境，依記錄修正工作負載或專案設定。
- 只有自動發現失敗，但手動位址與 SSH 正常：使用手動加入，不必更換主機。
- 主機可見但帳號沒有遠端登入權限：請管理員調整權限；不要共享密碼或私鑰。
- Mac 受學校管理、無法安裝或初始化 Xcode：改用符合課程要求的託管 Mac，先以空白專案驗收。
- 需要長期、高負載開發，或必須直接使用 USB、實體 iPhone 與其他硬體介面：租用遠端 Mac 未必是最合適的長期方案，本地 Mac 可能更省事。
你現在的解法若是學校電腦、同學借用的 Mac 或不穩定的雲端桌面，常見缺點是遠端登入權限不固定、Xcode 版本不能自行調整，以及重新連線後環境狀態不一定保留。相較之下，MACNOX 的遠端 Mac 租用適合先處理一個課程專案：你可以在購買前先確認所需的 macOS、Xcode 與 .NET MAUI 建置條件，再決定是否延長使用；若你需要的是臨時算力或測試環境，這通常比為了單一 iOS 作業立即購買整台 Mac 更容易控制投入。
完成空白專案驗收後，再依你的使用頻率選擇本地設備或遠端租用；若只是短期學習、測試與交作業，可先從 MACNOX 的可用方案確認環境，再把正式專案搬過去。