截至 2026 年 11 月 7 日，Apple 發布記錄列出 Xcode 27.2 已發布、Xcode 27.3 為 beta；要在現有專案快速試跑一段 Swift 程式碼，你可以使用 #Playground，再到 Canvas 查看結果。它適合小段實驗，不等於完整 App 建置或課程驗收。Apple 的 Xcode 發布記錄
最後更新：2026 年 11 月 7 日；版本狀態依 Apple Xcode 發布記錄與更新文件核對。
這篇適合想邊學邊執行短程式碼的 Swift 入門學生，以及分不清 #Playground、獨立 Playground 檔案和 SwiftUI Preview 的 Xcode 初學者。
如果你使用 Windows、但課程指定 Xcode，也可以依文中的驗收步驟先確認需要的 Mac 環境。
先選短小、容易看懂的練習
#Playground 是放在程式碼附近的 Playground 宏，可以讓你在 Xcode 中執行程式碼片段，並在 Canvas 查看結果；Apple 文件將它定位為片段實驗方式，而非完整專案流程。Apple 的 Playground 宏說明
初次練習，選「計算矩形面積」這類輸入與結果都清楚的小任務即可。你改動長或寬，就能觀察計算結果是否跟著改變；比起一開始建立完整 App，這更容易把注意力放在變數與運算上。
先確認練習目的：如果只是想理解一段函式或運算，片段實驗合適；若作業要求 App 能建置、在模擬器啟動，或提交完整專案，就不能只憑 Canvas 有顯示結果判定完成。
從現有專案挑選實驗位置
Xcode 專案中的 Swift 源檔，像是收納程式碼的文件；Canvas 則是查看預覽或片段執行結果的區域。開始前先找到課程允許修改的 Swift 檔案，保留原有程式碼，再挑一處不會干擾主要功能的位置做練習。Apple 的專案檔案管理說明可協助你了解檔案在專案中的組織方式。
先辨認三種用途，避免選錯工具：
| 工具 | 適合做什麼 | 不代表什麼 |
|---|---|---|
#Playground 宏 |
在 Swift 源檔附近試跑一小段程式碼；結果可在 Canvas 查看。宏文件 | 不是 App 已完整建置或作業已驗收 |
| 獨立 Playground 檔案 | 把實驗內容放在單獨文件中，與既有專案源檔分開管理 | 不等同於在原有 App 流程中完成建置 |
| SwiftUI Preview | 預覽 SwiftUI 介面，檢視介面呈現；Apple 將預覽宏用於介面預覽。預覽宏說明 | 不是一般 Swift 程式碼片段練習的替代品 |
若你的目標是測試一段計算或函式，優先試 #Playground；若想把多個實驗獨立整理，再考慮 Playground 檔案；若要看 SwiftUI 介面外觀，才使用 Preview。Apple 的 WWDC Xcode 示範也展示了 Xcode 中的 Playground 宏情境。
Xcode 27.2 #Playground 的 Swift 片段執行
在選好的 Swift 源檔中，將宏放在獨立實驗區域，再把程式碼放進大括號。以下以長方形面積為例；寫法依 Apple 宏文件，請在你實際使用的 Xcode 專案中執行確認：
#Playground {
let width = 4
let height = 6
let area = width * height
print(area)
}
你可以按以下順序操作：
- 開啟課程專案中的 Swift 源檔，確認目前編輯的是預期檔案。
- 在不覆蓋原有程式碼的位置加入
#Playground { }。 - 把短片段放進大括號，先確認變數名稱與括號完整。
- 依目前 Xcode 版本的編輯器介面啟動片段執行；若不確定入口，查看 Apple 的Xcode 編輯器與視窗設定說明。
- 開啟 Canvas 查看結果，再改動一個輸入值並重新執行，確認輸出是否相應改變。
編輯器畫面或入口可能隨 Xcode 版本、視窗配置而不同，因此不要只靠網路截圖認按鈕；以你安裝的版本和 Apple 文件為準。程式片段中的 print 是要觀察的輸出，Canvas 顯示結果也只說明這段實驗有執行，不代表整個 App 已成功建置。
Canvas 結果與第二次改動
Canvas 是檢視預覽與互動結果的區域。執行後，先確認結果是否符合計算邏輯，再改一個輸入值重跑；例如把寬度改掉，檢查面積是否也改變。Apple 的Canvas 互動說明介紹了在 Canvas 中檢視及操作預覽的方式。
SwiftUI Preview 可以代替片段練習嗎？
不適合直接互換。SwiftUI Preview 的重點是預覽介面；#Playground 則用來執行程式碼片段。若你在練習變數、條件判斷或函式，Preview 並不會因此替你完成一般片段實驗；若要檢查 SwiftUI 畫面，Preview 才是對應工具。Apple 的 Preview 說明
Canvas 沒有結果時，先核對執行環節
遇到空白或看不到預期輸出，不要立刻判定宏故障。依序檢查：
- 宏是否放對位置：確認
#Playground和大括號都在 Swift 源檔內，片段沒有被放到註解或字串裡。宏文件說明了在 Xcode 中執行程式碼片段的用法。 - Canvas 是否開啟：確認你查看的是 Canvas，而不是只停留在程式碼編輯區；可參考 Apple 的Canvas 操作文件。
- 執行是否完成：程式碼有語法錯誤或尚未完成執行時，不要把空畫面當成有效結果。先查看 Xcode 顯示的錯誤，再修正後重跑。
- 檔案與版本是否合適：確認你使用的是專案中的 Swift 源檔，並以目前 Xcode 版本的文件核對操作入口。Apple 發布記錄顯示 Xcode 27.2 已發布、27.3 為 beta；版本狀態請以官方發布記錄為準。
從片段實驗回到課程驗收
結束練習前，先做三項核對：你能說明程式碼在算什麼；Canvas 顯示的結果符合預期；課程要求是否還包含完整建置、執行 App 或模擬器測試。第三項若有要求，請回到課程規格逐項完成，不能用片段結果代替。
若符合以下條件，按右側建議選擇：
- 只要練習 Swift 語法，手邊已有可用的 Xcode：用
#Playground試跑短片段。 - 想把多段實驗獨立保存：使用獨立 Playground 檔案，再依課程要求決定是否另做專案建置。
- 課程要求檢查 SwiftUI 畫面：使用 SwiftUI Preview；若還要求 App 執行或提交，再完成相應驗收。
- 課程指定 Xcode，但你沒有可用的 Mac：先確認環境是否提供課程需要的 Xcode 版本、連線方式與使用權限；不要假設遠端環境一定符合要求。
在 Windows 上編輯一般 Swift 程式碼，和完成需要 Xcode 的建置並非同一件事；前者可能讓你先練習概念，卻不能替代課程指定的 Xcode 工作流程。購買 Mac 可取得本機環境，但有前期支出；遠端 Mac 省去購買實機，仍需要穩定網路，且你必須先核對版本、存取方式與權限。你可以查看 VpsHold 的遠端 Mac 環境資訊，再參照方案比較判斷是否符合課程要求。若只是短期練習或作業前測，先用自己的課程程式碼完成一次 #Playground 實驗；缺少 Mac、而課程接著要求完整 Xcode 建置時，再依核驗結果考慮租用環境。