跳轉到主要內容
歡迎在 Cursor 中開發 Swift!不管是打造 iOS App、macOS 應用,或是伺服器端 Swift 專案,我們都幫你準備好了。這份指南會帶你在 Cursor 中設定 Swift 開發環境,從基礎開始,再一路到更進階的功能。

基本工作流程

把 Cursor 當作主要的程式碼編輯器,同時用 Xcode 來建置與執行 app,是最簡單的 Swift 開發方式。你會用到這些超讚的功能:
  • 智慧程式碼自動完成
  • AI 驅動的程式碼輔助(在任何一行試試看 CMD+K
  • @Docs 快速看文件
  • 語法高亮
  • 基本程式碼導覽
需要建置或執行 app 時,直接切到 Xcode。這個流程很適合想運用 Cursor 的 AI 能力、同時在除錯與部署上維持熟悉的 Xcode 工具的開發者。

熱重載

當使用 Xcode workspace 或 project(而不是直接在 Xcode 開啟資料夾)時,Xcode 常會忽略在 Cursor 或其他外部工具對檔案做的變更。 雖然你可以改成在 Xcode 中直接開啟資料夾來解決,但在 Swift 的開發流程中,有時確實需要使用 project。 一個很不錯的解法是用 Inject,這是 Swift 的熱重載函式庫,能讓你的 app 在有變更時「熱重載」並即時更新。這種方式不會受到 Xcode workspace/project 問題的副作用影響,讓你在 Cursor 中修改後,能立刻反映到 app 上。

進階 Swift 開發

本指南的這一部分深受 Thomas Ricouard 以及他關於使用 Cursor 進行 iOS 開發的 文章 啟發。想了解更多細節可以看看他的文章,也別忘了追蹤他以獲得更多 Swift 內容。
如果想同時只開一個編輯器,並且避免在 Xcode 和 Cursor 之間來回切換,可以使用像 Sweetpad 這類延伸模組,把 Cursor 直接整合到 Xcode 的底層建置系統中。 Sweetpad 是一個強大的延伸模組,讓你可以在不犧牲 Xcode 功能的前提下,直接在 Cursor 中建置、執行與除錯你的 Swift 專案。 要開始使用 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(以及更多)的快捷操作包裝起來,讓你能像在 Xcode 一樣掃描 target、選擇目的地、建置並執行 App。除此之外,它也會替你設定 Xcode Build Server,讓你拿到上面提到的所有功能。

Sweetpad 使用方式

安裝好 Sweetpad,並在 Cursor 開啟一個 Swift 專案後,先執行 Sweetpad: Generate Build Server Config 指令。這會在專案根目錄產生 buildServer.json,讓 Xcode Build Server 能與你的專案協作。 接著,從指令面板或 Sweetpad 側邊欄選擇你要建置與執行的 target。
你需要先建置一次專案,才能啟用自動完成、跳至定義 和其他語言功能。
你也可以按 F5,用偵錯工具建置並執行專案——可能需要先建立啟動組態;出現提示時,從清單中選擇 Sweetpad 即可! 和 Cursor 的許多擴充功能一樣,你可以把多個 Sweetpad 指令綁定到鍵盤快速鍵,讓工作流程更有效率。 想更了解 Sweetpad,參考以下資源: