歡迎在 Cursor 中進行 Swift 開發！不管你是在打造 iOS app、macOS 應用程式，或是做伺服器端 Swift 專案，我們都幫你準備好了。這份指南會帶你在 Cursor 裡設定 Swift 開發環境，從基礎開始一路到更進階的功能。

​
基本工作流程

使用 Cursor 搭配 Swift 最簡單的方式，就是把它當成主要的程式碼編輯器，同時仍依賴 Xcode 來建置與執行你的 app。你會享有這些強大功能：
  • 聰明的程式碼自動完成
  • AI 驅動的寫碼輔助（在任何一行試試看 CMD+K）
  • 用 @Docs 快速查文件
  • 語法醒目標示
  • 基本程式碼導覽
需要建置或執行 app 時，只要切換到 Xcode。這個流程很適合想善用 Cursor 的 AI 能力，同時維持熟悉的 Xcode 除錯與部署工具的開發者。

​
即時熱重載

當使用 Xcode workspace 或 project（而不是直接在 Xcode 開啟資料夾）時，Xcode 常會忽略你在 Cursor 或其他非 Xcode 環境對檔案做的變更。 雖然把資料夾直接在 Xcode 打開可以暫時解決，但你的 Swift 開發流程可能還是需要使用 project。 一個很棒的解法是用 Inject，一個適用於 Swift 的熱重載函式庫，能讓 app 在你變更程式碼後即時「熱重載」並更新。它不會受到 Xcode workspace/project 問題的副作用影響，讓你在 Cursor 中做的修改能立刻反映到 app 上。

Inject - Swift 的熱重載

進一步了解 Inject，以及如何在你的 Swift 專案中使用它。

​
進階 Swift 開發

本指南這一節大量借鑑了 Thomas Ricouard 與他關於使用 Cursor 進行 iOS 開發的 文章。 想了解更多細節請參考他的文章，也別忘了追蹤他以獲得更多 Swift 內容。
如果你想一次只開一個編輯器，避免在 Xcode 和 Cursor 之間切換，可以用像 Sweetpad 這樣的擴充，把 Cursor 直接整合進 Xcode 的底層建置系統。 Sweetpad 是個強大的擴充，讓你可以直接在 Cursor 裡建置、執行與除錯 Swift 專案，同時不犧牲 Xcode 的功能。 要開始使用 Sweetpad，你仍然需要在 Mac 上安裝 Xcode —— 它是 Swift 開發的基礎。你可以從 Mac App Store 下載 Xcode。設定好 Xcode 之後，接著用幾個必要工具來強化你在 Cursor 裡的開發體驗。 打開終端機並執行： 
# 在不用開啟 Xcode 的情況下建置你的專案
brew install xcode-build-server

# 將 `xcodebuild` 指令的輸出美化後顯示在 Cursor 的終端機
brew install xcbeautify

# 提供進階格式化與語言功能
brew install swiftformat
接著，在 Cursor 裡安裝 Swift Language Support 擴充。這會直接提供語法高亮與基本語言功能。 然後，我們可以安裝 Sweetpad 擴充，把 Cursor 與 Xcode 整合。Sweetpad 將一系列圍繞 xcodebuild CLI（以及更多）的快捷功能包起來，讓你可以掃描 targets、選擇 destination、建置並執行你的 app，就像在 Xcode 一樣。除此之外，它也會為 Xcode Build Server 設定好你的專案，讓你獲得上述所有功能。

​
Sweetpad 使用方式

安裝好 Sweetpad 並在 Cursor 中打開一個 Swift 專案後，首先應該執行 Sweetpad: Generate Build Server Config 指令。這會在專案根目錄產生一個 buildServer.json 檔案，讓 Xcode Build Server 能與你的專案協作。 接著，從 Command Palette 或 Sweetpad 側邊欄選擇你想建置與執行的 target。
你需要先建置一次專案才能啟用自動完成、跳至定義與其他語言功能。
你也可以直接按 F5，用除錯器建置並執行專案 —— 你可能需要先建立一個啟動組態，但在提示時只要從清單中選擇 Sweetpad 就行！ 就像 Cursor 中的許多擴充一樣，你可以把許多 Sweetpad 指令綁定到鍵盤快捷鍵，讓你的工作流程更有效率。 想更了解 Sweetpad，看看這些資源：

Sweetpad Website

官方 Sweetpad 網站，包含功能與安裝說明

Sweetpad Guide

涵蓋設定、使用方式與進階功能的完整指南