截至 2026 年 10 月 5 日，Swift.org 的 macOS 安裝頁把 Swift 6.4.x 列在開發快照區，並註明快照不是正式發布版本；請先核對 Mac 目前使用的 Swift 工具鏈，再用 Swift Package Manager 建立小型程式庫或命令列練習，最後完成建置與測試。Swift.org 安裝頁提供版本狀態資訊。
適合剛開始學 Swift、第一次要建立可建置專案的學生。
使用 Windows 或受管理學校電腦、課程需要 macOS 環境的學習者，也可依本文判斷何時轉到遠端 Mac。
若課程指定 Swift 版本，先以課程要求為準，不要未經確認就改用預發布快照。
最後更新於 2026 年 10 月 5 日；版本狀態與操作步驟核對自 Swift.org macOS 安裝說明、Swift Package 入門文件及 Apple 的命令列工具說明。
[ SECTION_01 ] 先分清楚課程要交的是哪一種專案
Swift Package 是整理、建置和測試 Swift 程式碼的一種專案形式。可以把它想成裝程式碼的工作盒：裡面有程式檔案、描述專案的清單，以及測試程式碼。它不等同於完整的 iOS App 工程；如果作業要求製作 App 介面或使用 Xcode 專屬功能，單靠建立 Package 未必足夠。Swift.org 的套件文件說明套件的組成與用途。
第一次操作前，先確認課程要做以下哪一類練習：
- 可重複使用的程式庫：練習函式、資料處理或測試，程式碼可供其他程式使用。
- 命令列程式：輸入指令啟動程式，在終端機看到結果。
- Xcode App 專案：課程要求操作視窗、畫面或 iOS 功能時，依作業規定使用 Xcode 專案。
Swift Package Manager（常簡稱 SPM）負責建立、管理及建置套件；Swift 工具鏈則是實際提供 Swift 編譯器等工具的整組環境。可以把前者想成整理專案的工具，後者則是讓程式能被理解和編譯的工具。
[ SECTION_02 ] 第一步：確認終端機正在使用的工具鏈
先開啟 Mac 上的終端機，輸入：
swift --version
這個命令會顯示終端機目前呼叫的 Swift 版本。接著輸入：
which swift
它會指出目前找到的 swift 命令位置。若電腦上有 Xcode，也可用 Apple 提供的 xcode-select -p 檢查目前選用的開發者目錄；這有助於分辨終端機實際使用的環境，而不是只憑桌面上裝了哪個軟體來猜。Apple 命令列工具參考列有相關工具資訊。
查看結果後，按課程要求選擇現有環境：
- 課程指定 Xcode 工具鏈，而且 Mac 已有符合要求的環境，就先使用它。
- 課程指定 Swift.org 提供的工具鏈，才依官方安裝說明處理。
- 學校或遠端設備已設定好工具鏈，就先詢問管理者或查閱設備使用說明，不要自行繞過管理限制。
- 沒有明確要求時，不必為了練習而同時安裝多套工具鏈。
Swift.org 將 Swift 6.4.x 列為開發快照，並指出快照不屬於正式發布版本。因此，若課程沒有要求這個版本，穩妥做法是保留原有作業環境；想試快照時，另建練習用套件，先確認課程工具不會因此改變。Swift.org macOS 頁面是核對版本狀態的依據，不應自行推斷課程一定相容。
[ SECTION_03 ] 第二步：依練習目標選範本
先建立一個專門放練習的資料夾，再進入該資料夾。以下以 MyLibrary 作為資料夾與套件名稱示例；名稱可以換成課程允許的名稱。
mkdir MyLibrary
cd MyLibrary
若目標是建立程式庫，執行：
swift package init --type library
若目標是建立可直接執行的命令列練習，執行：
swift package init --type executable
兩種範本都會建立基本的套件檔案，但程式碼放置位置和驗收方式不同。程式庫範本通常把主要程式碼放在 Sources 目錄，測試放在 Tests 目錄；命令列範本則會提供可啟動的程式入口。若課程要求特定範本，直接照課程要求建立，不要只因為想看到輸出就把程式庫改成命令列程式。Swift.org 命令列套件入門與程式庫建立指南提供對應流程。
| 練習需求 | 建議範本與驗收方式 | 適配度 |
|---|---|---|
| 練習可重用程式碼 | library；以 swift build 建置，再用 swift test 執行測試 |
高：符合程式庫與測試練習 |
| 練習終端機輸入與輸出 | executable；建置後用 swift run 啟動，也可執行 swift test |
高：容易觀察執行結果 |
| 練習 iOS App 畫面或專屬功能 | 依課程要求建立 Xcode App 專案 | 低：單獨的 Package 不等於完整 App |
表中的適配度是按練習目的作出的編輯判斷，不是官方評分。Swift.org 的命令列教學示範建立和啟動可執行套件；程式庫教學則帶領讀者建立套件並執行測試。
[ SECTION_04 ] 第三步：先改範本程式碼，再理解清單檔
建立完成後，先查看目前目錄中的檔案，再找到 Sources 下面的範本程式碼。先只改一個小地方，例如新增一個回傳固定文字的函式，或在命令列程式中輸出一句訊息。這樣容易分辨問題來自程式碼，還是套件環境。
Package.swift 是套件清單，作用類似專案的目錄頁，描述套件名稱、程式碼目標與測試等資訊。初學時先保留範本設定，不必急著加入外部依賴或修改複雜欄位。套件和清單檔的基本關係可參考 Swift Package 的官方說明。
若使用遠端 Mac，記得確認正在編輯的是遠端 Mac 上的專案目錄。終端機連到遠端環境，不代表本機編輯器開啟的同名資料夾也會自動同步；可以在終端機確認所在路徑，再從該環境開啟或編輯檔案。若是學校電腦，請遵守設備管理規則，不要嘗試變更受限制的設定。
[ SECTION_05 ] 第四步：建置、執行與測試
先在套件根目錄執行建置：
swift build
建置用來檢查程式碼是否能編譯。接著按範本選擇驗收方式：
- 命令列套件可執行
swift run，觀察程式是否在終端機顯示預期結果。 - 程式庫可執行
swift test，確認範本測試能否通過。 - 若課程要求測試，也應實際執行測試，不要只以程式「看起來能跑」作為完成證明。
Swift.org 的命令列套件教學說明建置與執行流程；測試指南則說明 Swift 專案的測試做法。執行後查看終端機結果：建置沒有回報錯誤，代表該次建置完成；測試則要確認測試結果顯示通過，而不是只看命令有沒有啟動。
若失敗，按這個順序檢查，比直接重裝工具更有效：
- 終端機目前是否位於含有
Package.swift的套件根目錄。 swift --version顯示的版本是否符合課程指定環境。- 編輯器是否已儲存檔案，且改到遠端或本機的正確專案副本。
- 報錯指向程式碼、套件設定，還是工具鏈；依錯誤內容逐項排查。
不要把所有建置失敗都歸因於 Swift 版本。路徑錯誤、尚未儲存的檔案或程式碼語法錯誤，也都可能讓驗收失敗。
[ SECTION_06 ] 完成練習前的勾選清單
逐項確認後，再提交作業或開始下一個練習：
- [ ] 已確認課程要的是程式庫、命令列程式，還是 Xcode App 專案。
- [ ] 已在終端機檢查實際呼叫的 Swift 版本與命令位置。
- [ ] 已確認使用的工具鏈符合課程要求，沒有未經確認地換成開發快照。
- [ ] 已在正確的練習資料夾建立套件，並找到
Package.swift與範本程式碼。 - [ ] 已儲存修改，並確認操作的是正確的專案目錄。
- [ ] 已依套件類型執行建置、執行或測試，並檢查終端機結果。
- [ ] 已按課程規定保留提交所需的程式碼、測試與清單檔。
若每一項都能確認，通常就已完成第一個可驗收的 Swift Package 練習。往後再逐步學習新增測試、拆分程式碼或管理依賴，不必在第一個專案就改動所有設定。
[ SECTION_07 ] 常見問題
Swift 初學者要從程式庫還是命令列程式開始？
看課程要觀察什麼結果。程式庫適合練習可重複使用的程式碼，以及驗證函式是否符合預期；命令列程式則能直接在終端機啟動，較容易看到輸出。若作業指定專案類型，先照規定完成，避免提交格式不符。
要怎樣知道 Mac 終端機目前使用哪個 Swift 工具鏈？
在終端機執行 swift --version 檢視目前版本，再用 which swift 檢查命令位置。若使用 Xcode 工具鏈，也可檢查目前選用的開發者目錄。這些資訊比單看已安裝哪些軟體更能反映實際呼叫狀態；課程指定版本時，應以實際結果核對。
建立套件後，要用哪個命令建置、執行或測試？
在包含 Package.swift 的套件根目錄執行 swift build。命令列範本可用 swift run 啟動；程式庫範本則以 swift test 執行測試。若測試失敗，先核對目錄、工具鏈、檔案儲存狀態和課程要求，再按錯誤內容排查。
沒有本機 Mac，課程需要 macOS 時怎麼處理？
先看課程是否只要求 Swift 語法與套件練習，或是否明確要求 Xcode、macOS 功能或 iOS App 專案。若現有電腦能完成建置和測試，可以繼續使用；若設備無法提供課程要求的環境，再評估遠端 Mac。使用前也要確認遠端操作方式符合課程與學校規定。
[ SECTION_08 ] 何時才需要改用遠端 Mac
如果現有電腦已能使用符合課程要求的 Swift 工具鏈，並完成套件建置與測試，就沒有必要只為第一個 Package 改變環境。若課程要求 macOS 或 Xcode，而目前只有 Windows 或受限制的學校電腦，常見替代方式各有代價：本機虛擬環境可能不符合課程所需的 macOS 工具條件；借用設備受可用時間和帳號權限限制；改用其他環境也可能無法驗收 Xcode 專案。
這時可先閱讀 NOVAKVM 的 Mac 環境服務資訊，確認遠端操作方式是否符合課程；若決定短期租用，再查看遠端 Mac 方案說明，核對工具鏈、檔案保存與課程需求。遠端 Mac 不會自動解決課程版本或提交規定，使用前仍需逐項確認；若課程任務能在現有電腦完成，繼續使用原環境即可。
常見問題
第一次練習 Swift，應該建立程式庫還是命令列套件？
若課程要練習可重複使用的程式碼與測試，選程式庫範本；若要輸入指令後直接看到程式輸出，選命令列範本。兩者都是 Swift Package，但用途不同，也都不是完整的 iOS App 專案。課程指定類型時，應以作業要求為準。
如何確認終端機目前呼叫哪個 Swift 版本？
先在終端機執行 swift --version，查看實際回報的版本，再用 which swift 確認命令位置。若電腦裝有 Xcode 或額外工具鏈，版本與路徑要一起核對；不能只看已安裝的軟體名稱，就假設終端機正在使用它。
建立 Swift Package 後，怎樣確認它能執行或通過測試？
先確認終端機所在位置是套件根目錄，再執行 swift build。命令列套件可接著用 swift run；程式庫則以 swift test 執行範本測試。若步驟失敗，先核對目前目錄、工具鏈版本及課程指定環境，再依錯誤訊息定位問題。
Swift 6.4 快照可以直接拿來交課堂作業嗎？
只有在課程明確要求該工具鏈，且作業環境已確認相容時才考慮使用。Swift.org 的安裝頁會標示工具鏈所屬的版本狀態；預發布快照不應被當作穩定正式版。若只是想試新工具鏈，請另外建立練習套件，避免影響原有作業環境。