跳到主要内容

用 Cursor 开发 iOS App:打开 Xcode 工程、运行和断点调试

在 Cursor 里装免费插件快蝎,打开 Xcode 工程就有 Swift 代码补全,⌘R 运行到模拟器或 iPhone 并断点调试;AI 改完代码在同一窗口里构建验证,不用来回切到 Xcode。

用 Cursor 开发 iOS App,需要一台装好 Xcode 的 Mac,再在 Cursor 里装免费插件快蝎(KXApp)。装好后用 Cursor 打开你的 Xcode 工程,就有 Swift 代码补全;按 ⌘R 构建并运行到模拟器或 iPhone,断点停下时可以看变量。Cursor 的 AI 改完代码,你在同一个窗口里按 ⌘R 就能验证,不用来回切到 Xcode。以下内容截至 2026 年 10 月,适用 Xcode 16 及以上。

开始前准备:Mac 上已安装 Xcode 并打开过一次(完成附加组件安装),终端运行 xcode-select -p 输出在 Xcode.app 里面。

第一步:在 Cursor 里安装插件

Cursor 的扩展来自 Open VSX。打开扩展视图(⌘⇧X),搜索 kxapp,安装「快蝎」即可。

搜不到或网络受限时,也可以从安装页下载 kxapp.vsix,在扩展视图右上角「…」菜单里选「从 VSIX 安装…」。之后的用法和在 VS Code 里完全一样。

第二步:打开 Xcode 工程

用「文件 › 打开文件夹…」打开含有 .xcodeproj 或 .xcworkspace 的目录(工程可以在子目录里)。识别到工程后:

  • 左侧活动栏出现 Xcode 工程 视图,列出 Scheme、构建配置、运行目标、设备与模拟器。
  • 底部状态栏出现 Scheme、运行目标和构建按钮。

用 CocoaPods 的工程会自动选 .xcworkspace。工程不需要转换,同事继续用 Xcode 打开同一个工程不受影响。

第三步:写代码,补全开箱即用

打开 .swift 文件,输入 . 就有补全列表;F12 跳到定义,悬停看文档,错误实时标出。SwiftUI、Objective-C 也一样。

第一次打开工程时插件会在后台构建一次,Swift Package、CocoaPods 等第三方库的补全要等这次构建完成。之后补全按当前 Scheme 和运行设备计算,结果和在 Xcode 里一致。补全不出现时见代码补全指南。

第四步:⌘R 运行到模拟器或 iPhone

  1. 点状态栏的 Scheme,选要运行的 App。
  2. 点运行目标,选一台模拟器,或用数据线连着的 iPhone。
  3. 按 ⌘R。插件依次构建、安装、启动 App,并接上调试器。
快捷键 作用
⌘R 构建并运行(带调试器)
⌘B 构建,错误进「问题」面板
⌘. 停止

⌘R 和 ⌘B 只在编辑区有焦点、并且打开了 Xcode 工程时生效,⌘R 在调试进行中也不生效(先按 ⌘. 停止);按了没反应时先点一下代码区,或点 Xcode 工程视图标题栏上的「构建并运行」按钮(状态栏上的扳手图标是「构建」,只编译不运行)。iPhone 第一次使用前要信任电脑、打开开发者模式、在 Xcode 里登录 Apple ID,步骤见iPhone 真机运行与调试。

第五步:断点调试

在行号左侧点一下设断点,按 ⌘R。断点命中后,左侧调试视图里有变量、调用栈和线程;调试控制台里输入 po self 打印对象。条件断点、日志断点也能用。App 的 print / NSLog 输出在「输出 › kxapp Console」。

更多调试技巧见VS Code 调试 Swift:条件断点、日志断点、查看变量和控制台输出。

和 Cursor 的 AI 一起用

在同一个窗口里完成“AI 改代码 → 运行验证”:

  1. 在 Cursor 的对话或 Agent 面板里描述要改的功能,让 AI 修改代码。
  2. 看完改动后按 ⌘B 构建。编译错误会进「问题」面板,可以把错误交给 AI 继续修。
  3. 按 ⌘R 在模拟器或 iPhone 上运行(上一次调试还没停时先按 ⌘.),打断点确认行为是否正确。
  4. 需要时把「输出 › kxapp Console」里的日志贴给 AI,帮它定位问题。

改 Info.plist、App 图标、多语言、Build Settings 也不用离开 Cursor,直接打开这些文件就是可视化编辑器,见可视化编辑器指南。Interface Builder、Instruments、归档上传仍在 Xcode 里做,工程是同一个,随时可以切过去。

常见问题

Cursor 开发 iOS 还需要装 Xcode 吗?

需要。插件用 Mac 上已安装的 Xcode 来构建、签名和调试,所以结果和 Xcode 一致。装好之后,日常写代码、运行和调试都可以在 Cursor 里完成。

在 Cursor 的扩展里搜不到 kxapp 怎么办?

Cursor 从 Open VSX 获取扩展。搜不到时,从安装页下载 VSIX,在扩展视图「…」菜单里选「从 VSIX 安装…」。VSIX 安装的版本需要手动更新。

插件收费吗?Windows 上能用吗?

插件免费,不需要账号。它只支持 Mac,因为构建、签名和安装都要用本机的 Xcode。

AI 新建的 Swift 文件编译时找不到怎么办?

在 Xcode 16 及以上用文件夹(folder)方式组织的工程,放进文件夹的新文件会自动参与编译;用分组(group)方式的旧工程,新文件要在 Xcode 里加入 target 才会编译。