VS Code 怎麼連接遠端 Mac：2026 新手開發教學

電腦上的 VS Code 已經開啟，卻不知道程式究竟在 Windows 還是遠端 Mac 執行。

最快的解法是：用 VS Code 的 Remote - SSH 開啟遠端 Mac 上的專案，讓檔案、終端機命令與多數開發擴充功能在 Mac 上運作；需要 Xcode、iOS 模擬器或其他圖形工具時，再透過 VNC 或網頁控制台操作 Mac。

本週行動與完成時間表

我們建議本週先不要急著安裝一堆工具，也不要先修改權限。按照下表完成一次小型驗收，即可判斷這套方式是否適合課程作業。

本週建議動作：先用一個不重要的練習資料夾完成登入、讀寫與終端機測試，再把正式課程作業移到遠端 Mac。這樣即使帳號、校園網路或擴充功能出現問題，也不會先影響正在繳交的檔案。

這篇文章適合只有 Windows 或 Chromebook、需要臨時使用 macOS 開發環境的學生，也適合第一次接觸 SSH 的編程初學者。若您需要在學校公用電腦與個人設備之間繼續同一份作業，請特別留意檔案位置與備份方式。

先分清本機畫面與遠端工作區

可以把本機電腦想成課桌，把遠端 Mac 想成實驗室。課桌上的 VS Code 負責顯示編輯器，但透過 Remote - SSH 開啟的資料夾、終端機命令與相應的遠端擴充功能，主要是在實驗室那台 Mac 上處理。

Microsoft 的官方說明確認，Remote - SSH 可以開啟遠端主機上的資料夾，並在遠端環境執行命令與擴充功能；這正是 VS Code 連接遠端 Mac 的核心。詳情可參考 VS Code Remote - SSH 官方文件。

因此，網頁專案、一般 Python 練習與文字檔編輯，通常可集中在 VS Code 完成；但 Xcode 的視窗操作、iOS 模擬器點擊與部分系統設定，仍要進入 Mac 的圖形桌面。Apple 對 Xcode 在模擬裝置或實體裝置上執行 App 的說明，也把這類流程放在 Xcode 圖形介面中處理，請查看 Apple 的 Xcode 執行說明。

提醒：看到 VS Code 視窗在 Windows 上，不代表程式就在 Windows 上執行。每次開啟終端機後，先看目前路徑與工具版本，這比憑視窗外觀猜測更可靠。

連線能力與登入驗收

遠端 Mac 必須提供 SSH 登入入口。若由主機管理者設定，macOS 可在分享設定中啟用「遠端登入」，讓有權限的帳號透過 SSH 或 SFTP 存取；Apple 的 macOS 遠端登入指南說明了這項能力與設定位置。

開始前，請準備以下資料：

• 遠端 Mac 的主機名稱或 IP 位址。
• 可登入的 macOS 使用者名稱。
• 密碼或 SSH 金鑰，以及對應的登入方式。
• 要開啟的專案資料夾路徑。
• 若使用學校或公司網路，確認該網路沒有阻擋 SSH 連線。

在 Windows 上，先開啟 PowerShell，輸入：

ssh -V

這一步只在本機 Windows執行，目的是確認 SSH 指令是否可用；若顯示版本資訊，就停止，不必再安裝其他 SSH 工具。Microsoft 的 Windows OpenSSH 官方說明可用來核對 Windows 端的基本能力。

接著測試基本登入：

ssh 使用者名稱@遠端Mac位址

這仍然是在本機 PowerShell 輸入。第一次連線可能會出現主機指紋確認，請先核對來源，再接受；不要用關閉安全驗證的方式「修好」連線。成功後，終端機提示字元與目前路徑應代表遠端 Mac。若要求密碼，輸入時畫面通常不會顯示字元，這不代表沒有輸入。

若這一步失敗，先不要開 VS Code。帳號錯誤、位址錯誤、權限不足或校園網路限制，都可能被誤認成編輯器故障。Chromebook 則要先確認目前使用的系統環境是否提供終端機與 SSH，再採用相同的基本測試思路。

檔案與終端機能力

在 VS Code 中安裝 Remote - SSH 後，從遠端連線選單選擇主機，完成驗證，再選取遠端 Mac 上的專案資料夾。官方的 Remote - SSH 連線教學展示了這個基本流程；實際介面名稱可能隨版本調整，因此應以當下畫面為準。

第一次開啟後，做一個低風險驗收，不要直接執行安裝指令：

第一步：確認視窗狀態。 左下角應顯示遠端連線狀態，檔案總管開啟的路徑應是 Mac 上的資料夾，而不是本機下載資料夾。

第二步：建立測試檔。 在遠端專案資料夾內建立 remote-check.txt，寫入一行文字並儲存。接著關閉再重新開啟它，確認內容仍然存在。

第三步：檢查目前路徑。 在 VS Code 的遠端終端機輸入：

pwd

用途是查看目前所在資料夾；預期結果應是遠端 Mac 的路徑。若路徑不是預期的專案目錄，先停止，不要執行安裝或刪除命令。

第四步：檢查工具位置。 可輸入：

uname -s

用途是確認命令是在遠端系統回應。接著可依課程需要檢查 Python 或其他工具，但不要把版本號當成本文固定要求，因為實際環境與課程規定可能不同。

第五步：只在遠端視窗修改檔案。 如果同一份作業同時存在於本機與遠端，請在檔名或資料夾上做清楚區分。最常見的錯誤不是 SSH 本身，而是改了 A 副本、交出 B 副本。

若要讓檔案可以在不同設備之間帶走，請依課程要求使用版本控制、下載壓縮檔或其他備份方式。遠端連線是工作入口，不等於自動備份服務。

擴充功能與圖形介面的任務邊界

介面主題、部分顯示類擴充功能可能留在本機；Python、程式分析、除錯或需要讀取遠端檔案的功能，通常要在遠端視窗安裝。VS Code 官方的 遠端擴充功能機制說明指出，擴充功能可依工作位置分開處理，因此安裝按鈕旁若出現「安裝到遠端」之類的提示，應依畫面選擇，而不是盲目重複安裝。

這個評分不是速度測試，而是「只使用 VS Code 是否足以完成任務」的判斷。若課程只是寫程式與執行測試，遠端開發工作流較完整；若課程要求拖曳介面、啟動模擬器或調整 macOS 設定，就要準備 VS Code 加圖形桌面的雙軌方式。

斷線恢復與故障分流

連線不穩定時，請按照故障出現的位置分流，而不是立刻刪除遠端資料夾或修改權限。

• 基礎 SSH 已失敗： 回到 PowerShell 或 Chromebook 終端機，重新檢查位址、帳號、金鑰、密碼與網路限制。
• SSH 成功但 VS Code Server 啟動失敗： 查看 Remote - SSH 輸出的記錄，核對遠端環境與官方要求。
• 擴充功能無法下載： 先確認遠端主機能否連到所需服務，再檢查擴充功能是否應安裝在遠端。
• 校園網路限制： 改用獲授權的網路或詢問網路管理者，不要自行繞過安全規則。

Microsoft 的 Remote - SSH 故障排查文件建議優先查看輸出記錄；官方 FAQ 也整理了 連線要求與常見問題。這些資料比網路留言中的「刪掉某個資料夾就好」更適合作為第一層判斷依據。

重新連線後，請分別確認三件事：未儲存的編輯是否存在、正在執行的命令是否仍在、背景服務是否需要重新啟動。短暫斷線通常不代表遠端專案消失，但不能因此推論所有執行狀態都會保留。

首次遠端開發勾選清單

完成以下項目後，再決定是否把整門課程搬到遠端環境：

• [ ] 能在本機終端機用正確帳號測試 SSH。
• [ ] 能辨認主機指紋，且沒有關閉安全驗證。
• [ ] VS Code 左下角顯示目前已連線到遠端主機。
• [ ] 開啟的資料夾確實位於遠端 Mac，而不是本機副本。
• [ ] 測試檔能在遠端資料夾建立、儲存並重新開啟。
• [ ] 遠端終端機的目前路徑符合專案位置。
• [ ] 一條低風險版本檢查命令能正常回應。
• [ ] 必要的 Python、分析或除錯擴充功能安裝在正確位置。
• [ ] 已知道哪些課程步驟需要 Xcode 或 macOS 圖形桌面。
• [ ] 已用下載、版本控制或課程指定方式保存可帶走的作業副本。
• [ ] 斷線後能重新登入，並能分辨檔案、命令與背景服務的狀態。

若只有前八項通過，表示 VS Code 遠端編輯與終端機工作流大致可用；若最後三項未通過，則不適合直接把遠端主機當成唯一作業環境。課程需要 Xcode 或 iOS 模擬器時，應選擇 VS Code 與圖形桌面並行，而不是強行只用 SSH。

給學生的方案判斷

若目前方案是學校公用 Windows 電腦，常見限制包括不能安裝必要擴充功能、重新開機後環境被清除，以及校園網路可能限制 SSH；只在本機使用也會無法取得 macOS 專屬工具。macOS 虛擬機則可能受硬體資源、系統授權與圖形效能限制，未必適合第一次做 Xcode 課程作業。

完成 SSH 與 VS Code 的基礎驗收後，若課程還需要 Xcode、iOS 模擬器或其他 macOS 專屬工具，我們會建議先租用一台具備完整權限的遠端 Mac 做一次完整作業驗收，再判斷是否值得購買實體 Mac。這樣能把「真的需要 Mac」與「只是需要遠端檔案和終端機」分開計算，也避免為一門尚未確定的課程先承擔硬體成本。

若您要比較按需使用的方案，可先查看 JexMac 的方案資訊；若遇到登入入口、連線方式或檔案操作疑問，則可參考 JexMac 使用說明。對臨時課程、短期測試與需要 Xcode 圖形操作的學生而言，先完成一次可帶走作業的驗收，通常比直接長期購買設備更容易控制風險。

常見問題