症狀:Swift 課程要求的版本不確定,或安裝後不知道能不能執行程式。
最快解法:先核對課程指定的 Swift、Xcode 與 macOS 條件;若要開發 Apple 平台 App,優先使用符合要求的 Xcode,再檢查實際工具鏈並編譯一個小程式。
本文適合第一次接觸 Swift、要在 Mac 準備編程環境的學生;課程指定特定版本的學習者,也可按步驟確認工具鏈是否相符。
如果你準備學 iOS 或 macOS 開發,本文會協助你分清楚「能執行 Swift 程式」與「具備完整 Apple 平台開發環境」的差別。
最後更新於 2026 年 10 月 21 日;Swift 與 Xcode 版本資訊依 Swift 官方安裝指南及 Apple 的 Xcode 27 發行說明核對。系統相容條件可能因工具版本而異,下載前仍應查看官方頁面及課程要求。
動手前先核對課程指定的環境
先找出課程頁面或作業說明中的 Swift 版本、Xcode 版本與 macOS 要求。這幾項不是同一件事:Swift 是程式語言及其工具鏈,Xcode 則是 Apple 的開發環境,內含供 Apple 平台開發使用的工具。課程若指定版本,別只看到電腦上「有 Swift」就假設符合要求。
例如,課程只要你練習變數、函式及命令列輸出,通常可以先確認 Swift 編譯工具是否可用;若作業要求建立 iOS App、使用模擬器或匯出 Apple 平台專案,就要確認課程要求的 Xcode 與平台工具都能使用。依照 Xcode 系統要求,安裝前還要核對你的 macOS 是否符合相應版本條件,不能假設所有 Mac 都能使用同一版 Xcode。
Swift 6.4 怎麼在 Mac 上安裝?
若目標是 Apple 平台開發,先依課程指定的 Xcode 版本選擇安裝路線,再確認該版本包含的 Swift 工具鏈。若你只是練習語法,可查閱 Swift 官方入門與安裝資料及 macOS 安裝說明;不同方式取得的工具,不代表都具備完整 Xcode 功能。
按學習目標選擇安裝路線
| 你的目標 | 建議先準備 | 這條路線適合什麼 | 需要留意 |
|---|---|---|---|
| 練習 Swift 語法、執行命令列程式 | Swift 官方支援的 macOS 安裝方式,或課程指定的工具 | 入門練習及不依賴 Apple App 專案的作業 | 先確認取得的版本符合課程要求 |
| 開發 iOS 或 macOS App | 符合課程與 macOS 相容條件的 Xcode | 使用 Apple 平台 SDK、模擬器及 Xcode 專案 | 需核對 Xcode 版本及系統要求 |
| 只裝獨立命令列工具 | Apple 的 Command Line Tools | 課程明確要求的終端機工具或編譯流程 | 不等同完整 Xcode,也不能當成 iOS App 開發環境 |
Apple 說明,獨立的 Command Line Tools 與完整 Xcode 是不同安裝選項;你可參考命令列工具安裝文件。如果課程要你操作 Xcode 專案、模擬器或 Apple 平台 SDK,只安裝命令列工具便不夠。若課程只要求編譯簡單的 Swift 程式,則先按課程說明確認工具即可,不必為了「看起來完整」而安裝不需要的環境。
依官方路徑安裝所需工具
決定路線後,再下載工具。不要使用來路不明的安裝包,也不要因網頁顯示有新版,就略過課程指定版本與 macOS 相容性核對。
若需要完整 Xcode,請透過 Apple 官方提供的取得方式安裝,並先查看 Xcode 系統要求及版本說明。寫作時的官方資料指出,Xcode 27 系列工具鏈包含 Swift 6.4;這不表示所有 macOS 版本都能安裝該系列,也不代表你的課程一定要求它。版本是否合用,仍以課程指定和 Apple 列出的系統條件為準。
若只需 Swift 語言工具,可查看 Swift 的 macOS 安裝指南。官方文件提供平台安裝資訊;若選用安裝包,請依官方安裝包說明操作,並核對所下載工具的版本。不要把獨立 Swift 安裝方式與完整 Xcode 當成可以任意互換的兩套同等環境。
安裝後先確認終端機正在使用的版本
開啟「終端機」,輸入:
swift --version
若要確認編譯器版本,也可輸入:
swiftc --version
這些命令顯示的是目前命令列找到的 Swift 工具版本。將輸出與課程要求比對;若不一致,先檢查目前選用的 Xcode 或工具鏈,不要直接開始大型作業。Apple 的 Xcode 發行說明可用來核對該版本所附工具鏈資訊;不同安裝來源或選用設定,可能令終端機實際呼叫的工具不同。
怎麼確認 Mac 上安裝的 Swift 版本?
以 swift --version 查看終端機目前找到的 Swift 版本,再與課程要求對照。若你同時準備了不同來源的工具,版本不符時先確認目前選用的開發工具;不要把下載完成、安裝完成和已使用正確版本視為同一件事。
編譯並執行第一段 Swift 程式
先建立檔案 hello.swift,輸入以下內容:
print("Hello, Swift!")
在終端機切換到該檔案所在的資料夾,接著編譯並執行:
swiftc hello.swift -o hello
./hello
若終端機印出 Hello, Swift!,代表目前工具至少能完成這個簡單程式的編譯與執行。這只是基本檢查,並不代表 Xcode 專案、iOS 模擬器或其他 Apple 平台工具都已準備好。若課程使用 Swift Package Manager 專案,可再按照 Swift 官方命令列教學熟悉專案執行方式,並以課程指定流程為準。
安裝 Swift 後怎麼執行第一段程式?
用文字編輯器建立上述檔案,再以 swiftc 編譯並執行產生的程式。若出現錯誤,先確認終端機位於檔案所在資料夾,並檢查命令輸入和檔名;不要只憑編輯器能開啟程式碼,就判斷編譯工具正常。
開始課程練習前確認環境是否夠用
只安裝命令列工具能不能做 iOS 開發?
不能把它當作完整 iOS 開發環境。獨立 Command Line Tools 可供部分終端機工作使用,但 Apple 說明的完整 Xcode 能力與其不同;若課程需要 Xcode 專案、iOS SDK 或模擬器,就應依課程要求準備相容的 Xcode。
開始作業前,可依序確認:
- 課程指定的 Swift 與 Xcode 版本已記錄下來。
- 目前 macOS 符合所選工具版本的官方系統要求。
swift --version顯示的版本符合課程要求。- 簡單程式已成功編譯並執行。
- 若課程涉及 iOS 或 macOS App,Xcode 與課程所需的平台工具也可使用。
如果你手邊只有 Windows 電腦,或學校設備不允許安裝開發工具,虛擬機或借用電腦未必能提供課程要求的完整環境;實際可用性還取決於硬體、權限及課程使用的 Apple 工具。先確認課程是否要求完整 macOS 與 Xcode 工作流,再決定是否需要另一台 Mac。需要遠端操作時,可先查看 macworker 的遠端 Mac 連線方式,並按課程要求核對租用方案資訊。
自己安裝的環境最直接,但你要自行處理相容性、安裝權限與工具鏈版本;借用設備可能受使用時段和管理限制;虛擬環境則需先確認能否滿足課程指定的 Apple 工具。若這些限制已妨礙課程練習,而你又沒有合適的本地 Mac,租用 macworker 的遠端 Mac 可作為先完成作業、再決定長期方案的選擇。若你需要長期固定使用,或課程要求特定實體介面,先評估自有設備是否更合適;不論選哪條路,開始前都要重新核對課程版本與實際工具鏈。
用 macworker 遠端準備 Swift 開發環境
租用獨享 Apple Silicon 實體 Mac,依課程需要安裝並核對 Swift 工具鏈,開始編譯與執行程式。
