SweetPad 是什麼:用 VS Code、Cursor 開發 iPhone App,不必一直切回 Xcode

SweetPad:用 VS Code、Cursor 開發 iPhone App(文章封面)

開發工具介紹 / 資料更新至 2026 年 11 月

用 Cursor 或 Claude Code 寫 iPhone App 的人,大多遇過同一個麻煩:AI 在編輯器裡寫程式寫得很順,可是一到建置、開模擬器、看錯誤訊息,就得切回 Xcode。兩個視窗來回跳,AI 也看不到 Xcode 裡發生了什麼事。

SweetPad 就是為了這件事出現的免費開源工具。它讓你在 VS Code 或 Cursor 裡建置、執行、除錯、測試 iOS 與 macOS App,也提供一支終端機指令,讓 AI 編程助手能自己編譯、讀錯誤、再修正。這篇整理它是什麼、能做什麼、怎麼裝,以及它還做不到的地方。

30 秒看重點

免費開源

MIT 授權,原始碼放在 GitHub,約 1.9k 顆星。

約 6.5 萬次

VS Code 擴充套件的安裝次數(2026 年 11 月)。

5 個平台

iOS、macOS、tvOS、watchOS、visionOS 都能建置。

7 行 vs 350 行

官方說明:小型 App 建置時,SweetPad 只印 7 行,原本的 xcodebuild 印 350 行。

仍要 Mac+Xcode

它是呼叫 Apple 的工具,不是取代;Linux 版還在實驗階段。

資料:SweetPad GitHub 與官方文件、VS Code Marketplace,詳見文末資料來源。

01SweetPad 是什麼:讓 VS Code 也能跑 Xcode 專案

開發 iPhone App,傳統上幾乎只能用 Apple 的 Xcode。VS Code 雖然是很多人每天在用的編輯器,但它本身不知道怎麼編譯 Xcode 專案、怎麼開 iOS 模擬器,打開專案後連程式碼自動完成都常常失靈。

SweetPad 的做法是當一個「中間人」:你在編輯器裡按下執行,它去呼叫 Mac 上的 xcodebuild 等 Apple 官方工具完成建置,再把 App 裝到模擬器、iPhone 或 Mac 上執行,日誌直接顯示在編輯器裡。它支援 Xcode 專案與 workspace、Tuist、XcodeGen 和 Swift Package。

SweetPad 站在中間,幫你跑 Apple 的工具你寫程式VS Code、Cursor或 AI 編程助手SweetPadVS Code 擴充套件或 sweetpad 指令Apple 官方工具xcodebuildXcode 內建工具看到結果模擬器、iPhone或 Mac注意:Mac 上仍要安裝 Xcode只是不用整天開著它,寫程式和執行都留在同一個編輯器
圖 1 SweetPad 的角色:在編輯器和 Apple 官方工具之間跑腿

這個專案由開發者 Yevhenii Hyzyla 在 2024 年發起,目前仍在快速更新:VS Code 擴充套件 2026 年 11 月 2 日推出 0.2.21 版,指令工具(CLI)在 11 月 13 日推出 0.1.23 版。顧問公司 Thoughtworks 在 2025 年 11 月的技術雷達中,也把 SweetPad 列在「評估(Assess)」,意思是值得花時間了解。

技術雷達是什麼

Thoughtworks 每半年整理一次值得注意的技術,分成採用、試行、評估、暫緩四個等級。「評估」代表值得研究,但還不到建議全面採用的程度。

02兩種用法:擴充套件給編輯器,指令給終端機與 AI

SweetPad 其實是兩個獨立的工具,共用同一套核心程式。官方文件說得很直接:不需要兩個都裝,看你在哪裡工作就選哪一個。

你的情況建議用原因
習慣用 VS Code 或 Cursor
想像在 Xcode 一樣按一下就執行
擴充套件側欄點一下就能建置、執行、設中斷點
整天在終端機工作
或用 Neovim、Zed 等編輯器
CLI 指令不依賴 VS Code,任何終端機都能用
想讓 AI 自己編譯、修錯
Claude Code、Codex、Cursor 代理
CLI+官方技能檔輸出可以是 JSON,AI 讀得懂
要放進自動化流程
git hook、CI 持續整合
CLI 指令每個指令都有固定的結束代碼

資料:SweetPad 官方文件〈CLI or VS Code extension?〉,2026 年 11 月。

要記得

兩者只有一個交集:擴充套件預設的程式碼自動完成,是靠 CLI 裡內建的 build server 運作。所以想在 VS Code 裡有完整的自動完成,CLI 也要一起裝。

03擴充套件能做什麼:Xcode 的日常工作大多搬得過來

安裝擴充套件後,左側活動列會多一個棒棒糖圖示,點開就是 SweetPad 的工作區。側欄主要分成三塊:Build 列出專案的 Scheme,旁邊有執行鍵;Destinations 列出所有能執行的地方;Tools 則是常用輔助工具的一鍵安裝。

SweetPadBuildMyAppMyAppTestsDestinationsiPhone 模擬器已連線的 iPhoneMy MacToolsswift-format、xcbeautify…建置與 App 日誌Build succeededApp launched on simulator
圖 2 SweetPad 側欄示意:Build、Destinations、Tools 三個區塊

官方列出的主要功能如下:

1

建置與執行

在模擬器、Mac 或接上的實體 iPhone 上執行 App。

2

除錯

可下中斷點、逐行執行、觀察變數,模擬器與實機都支援。

3

日誌集中看

print、Logger、NSLog 的輸出直接進編輯器,不用另外開 Console。

4

測試

XCTest 與 Swift Testing 會出現在 VS Code 的測試面板。

5

存檔自動排版

預設使用 Xcode 內建的 swift-format,也能換成其他格式工具。

6

自動完成與錯誤提示

透過 SourceKit-LSP 提供補完、跳到定義、即時編譯錯誤。

7

熱重載

存檔後直接把改動套用到執行中的 App,不必重新建置。

熱重載有限制

熱重載是整合開源專案 InjectionNext 做到的,只支援 iOS、tvOS、visionOS 模擬器與 macOS。實體 iPhone 因為 Apple 的程式簽章機制不能用,watchOS 也不支援。

04五分鐘上手:從安裝到在模擬器跑起來

你需要一台已經安裝 Xcode 的 Mac。以下以 VS Code 為例,Cursor 的步驟完全相同。

步驟一:安裝擴充套件

打開 VS Code,按 Cmd+P 開啟快速開啟,貼上下面這行再按 Enter。也可以直接在擴充套件市集搜尋 SweetPad。

VS Code 快速開啟指令

ext install sweetpad.sweetpad

步驟二:打開專案資料夾

用「開啟資料夾」打開專案的根目錄,也就是裝著 .xcodeproj 或 .xcworkspace 的那一層,不要直接打開 .xcodeproj 本身。還沒有專案的話,可以先用 Xcode 建一個空白 App。

步驟三:按執行

1

點左側棒棒糖圖示

打開 SweetPad 側欄。

2

在 Build 區按 Scheme 旁的執行鍵

第一次會問你要用哪個模擬器或裝置。

3

等建置完成

SweetPad 會開模擬器、安裝並啟動 App,日誌出現在下方終端機。

步驟四(建議):打開自動完成

先在擴充套件市集安裝官方的 Swift 擴充套件,再用 Homebrew 安裝 SweetPad 的指令工具:

終端機指令

brew install sweetpad-dev/tap/sweetpad

接著在 VS Code 按 Cmd+Shift+P,執行「SweetPad: Generate Build Server Config」。它會在專案根目錄產生 buildServer.json,之後打開 Swift 檔案就有自動完成了。官方說明,這個內建 build server 直接讀專案設定,不必先建置一次。

已經在用 xcode-build-server 的人

原本的設定不會被換掉。SweetPad 看到專案裡已有其他工具產生的 buildServer.json,就會沿用它。

05指令工具與 AI 代理:讓 AI 自己編譯、自己看錯誤

如果你用 Claude Code、Codex 這類在終端機工作的 AI 編程助手,CLI 才是重點。它的 GitHub 首頁標語是「給人類和 AI 代理用的 xcodebuild」。在專案資料夾裡,日常只要幾個短指令:

CLI 常用指令

cd MyApp
sweetpad run
sweetpad devices
sweetpad run --on "iPhone 16 Pro"
sweetpad test --on booted

第一次執行 sweetpad run 會問你要建置哪個 Scheme、在哪裡執行,之後就記住了。--on 後面的名稱請換成 sweetpad devices 列出來的模擬器或裝置名稱;booted 代表「目前已經開著的模擬器」。執行中按 r 重新建置、按 q 離開。

裝上官方技能檔

SweetPad 另外提供給 AI 代理用的技能檔(Agent skills),教 AI 怎麼正確使用這支指令,例如用 JSON 模式讀結構化輸出、建置失敗時直接讀診斷訊息而不是重跑。官方說明它支援 Claude Code、Cursor、Codex、Copilot、Gemini 等讀得懂開放技能格式的工具,一行安裝:

終端機指令

npx skills add sweetpad-dev/sweetpad

裝好之後,就可以用一般的話交代 AI 工作。下面是一段可以直接用的提示詞:

提示詞範例/交代 AI 建置與修錯

請用 sweetpad 指令建置這個專案,並在 iPhone 模擬器上執行。
如果建置失敗:
1. 先讀錯誤訊息,告訴我是哪個檔案、哪一行、什麼原因。
2. 修正後重新建置,直到成功為止。
3. 最後用三句話說明你改了什麼。
不要修改專案的簽章與 Bundle ID 設定。

為什麼對 AI 特別有用

原本的 xcodebuild 一次建置會吐出幾百行訊息,AI 很難從中找到真正的錯誤,也很耗 token。SweetPad 把輸出精簡到幾行,又能輸出 JSON,AI 讀得快、判斷也比較準。

但它不是 Xcode 的替代品

SweetPad 解決的是「不必一直切回 Xcode」,不是「完全不需要 Xcode」。開始使用前,這幾件事要先知道:

一定要有 Mac 和 Xcode

VS Code 擴充套件只支援 macOS。底層呼叫的是 Xcode 的命令列工具,Xcode 還是得裝。

Linux 版還在實驗

CLI 已能在 Ubuntu 上建置並安裝到 iPhone,但官方標示為實驗性;模擬器與執行測試仍需要 Mac,Apple 的 SDK 也要從自己的 Mac 環境匯出。

版本號還是 0.x

擴充套件 0.2 版、CLI 0.1 版,功能和設定方式變動快。用在正式專案前,建議先在小專案試過。

有些事還是回 Xcode 做

例如 Apple 開發者帳號、簽章憑證的管理,以及 Xcode 獨有的視覺化工具。SweetPad 讓你少開 Xcode,不是不開。

誰適合試試看

已經在用 AI 寫程式的人

在 Cursor 或 Claude Code 裡寫 Swift,又不想來回切視窗,SweetPad 能把建置和修錯留在同一個地方。

學 Swift 的學生

如果平常就用 VS Code 寫 Python 或網頁,可以用熟悉的介面跨進 App 開發,少一層學習負擔。

帶程式課的老師

同一套編輯器教多種語言,學生不必每換一門課就重學一個工具;但上課電腦仍要是裝好 Xcode 的 Mac。

想動手試的話,建議照這個順序:

1

先用 Xcode 建專案

建一個空白 SwiftUI App,確認在 Xcode 裡能正常執行。

2

再用 VS Code 打開

照第 04 節裝擴充套件、按執行,看模擬器有沒有跑起來。

3

最後交給 AI

裝 CLI 和技能檔,請 AI 改一個畫面再自己建置驗證。

好工具不是讓你少學,而是讓你把力氣花在真正要學的東西上。

本文重點

  1. SweetPad 是免費開源工具,讓 VS Code、Cursor 能建置、執行、除錯、測試 Xcode 專案。
  2. 分成擴充套件與 CLI 兩個工具,依工作習慣擇一;要自動完成就兩個都裝。
  3. CLI 輸出精簡、支援 JSON,再加上官方技能檔,適合交給 AI 代理自己建置與修錯。
  4. 它呼叫的是 Apple 的工具,仍需要 Mac 與 Xcode;Linux 版與部分功能還在實驗階段。

想一想

如果 AI 已經能自己編譯、讀錯誤、改程式,學寫 App 的人最該花時間練的,會是哪些 AI 做不到的能力?

資料來源

  1. SweetPad(2026 年 11 月)。GitHub 專案首頁與 README
  2. SweetPad 官方文件。CLI or VS Code extension?
  3. SweetPad 官方文件。Get started with the extension
  4. SweetPad 官方文件。VS Code extension 功能總覽
  5. SweetPad 官方文件。Autocomplete
  6. SweetPad 官方文件。Hot reload
  7. SweetPad 官方文件。Agent skills
  8. SweetPad 官方文件。Build iPhone apps on Linux
  9. SweetPad(2026 年 11 月 2 日)。VS Code 擴充套件更新紀錄
  10. Visual Studio Marketplace(2026 年 11 月)。SweetPad (iOS/Swift development)
  11. Thoughtworks(2025 年 11 月 5 日)。Technology Radar:SweetPad

本文示意圖為程式繪製,封面插圖為 AI 生成。


Edit with Tr.Bug

Follow me on:LinkedIn | 探教育TempEDU