这篇文章将分享我如何为Swift项目配置和使用 Cursor。
准备工作
首先,你需要下载 Cursor。这款编辑器本身是免费的,但我后面会演示的部分功能需要订阅(费用为 20 美元)。我并非在为它推销,值不值得订阅完全由你自己判断。免费版本可以满足基础使用需求;此外,如果你已经购买了 OpenAI、Claude 或 Gemini 的服务,还能在 Cursor 的设置中填入对应的 API 密钥来调用这些模型。
Cursor人工智能代码编辑器www.cursor.com
下载完成后,你还需要安装几个插件和 brew 包。
1. 安装 Xcode Build Server
运行
brew install xcode-build-server
这个工具能让 sourcekit-LSP 在 Xcode 外部正常工作,帮你实现跳转至定义、查看所有引用、调用树分析等功能。几乎所有你在 Xcode 里能用到的代码编辑功能,在 Cursor 中都能实现。
点击或按回车键查看完整尺寸图片
运行着 Xcode Build Server 的 Cursor 代码编辑器界面
2. 安装 xcbeautify
brew install xcbeautify
它能让 Cursor 终端里的 xcodebuild 输出内容排版更整洁易读。
点击或按回车键查看完整尺寸图片
使用 xcpretty 构建项目时的 Cursor 终端界面
3. 安装 SwiftFormat(如未安装)
brew install swiftformat
4. 安装 Cursor 插件
打开 Cursor,进入扩展面板,安装以下两款插件:
- Swift language support提供 Swift 语法高亮及完整的语言特性支持。
- Sweetpad这款插件是实现「脱离 Xcode 图形界面完成开发流程」的核心工具。建议你去插件官网浏览它的功能列表、快捷键和使用方法。本文会介绍其中部分功能,但不会面面俱到。
Sweetpad 插件的功能列表
Sweetpad 为 xcodebuild 命令行工具封装了大量快捷键(还有更多其他功能),支持扫描项目目标、选择运行设备、构建和运行应用,操作体验和 Xcode 完全一致。除此之外,它还会自动为项目配置 Xcode Build Server,让你用上前面提到的所有功能。
安装好 Sweetpad 后,按下 CMD+SHIFT+P 打开命令面板,选择:
Sweetpad: Generate Build Server Config
点击或按回车键查看完整尺寸图片
这个操作会在项目根目录生成 buildServer.json 文件,让 Xcode Build Server 能够识别并处理你的项目。
点击或按回车键查看完整尺寸图片
配置完成后,通过命令面板执行「构建并运行」操作,或者直接点击 Cursor 界面上的 Sweetpad 标签(建议固定该标签)。在 Sweetpad 面板中,你可以浏览项目所有的 Target,并选择任意一个运行。
重要提示:这一步至少要构建一次项目,这样才能启用自动补全、跳转至引用等功能。
5. 配置调试功能
按下 F5 即可启动调试功能。首次使用时可能需要创建调试模式的启动配置,弹出选项时直接选择 Sweetpad 即可。你可以先执行「构建并运行」,之后再附加调试器;也可以在「运行和调试」面板中选择「Attach to running app」(附加到正在运行的应用),如果应用尚未启动,该操作会自动构建、运行应用,再附加调试器。
点击或按回车键查看完整尺寸图片
调试器正常运行且触发断点的 Cursor 界面
你能获得和 Xcode 完全一致甚至更丰富的调试功能:断点调试、查看调用栈、变量监视与打印、逐行执行代码等。
最终你的 ./vscode/launch.json 文件内容应如下所示:
{
"version": "0.2.0",
"configurations": [
{
"type": "sweetpad-lldb",
"request": "launch",
"name": "Attach to running app (SweetPad)",
"preLaunchTask": "sweetpad: launch"
}
]
}
写在最后
由于时间有限,本文的介绍无法做到面面俱到,但希望能为你提供一个新思路 —— 除了 Xcode,你还可以用其他编辑器高效开发 iOS 项目。
🚀 祝大家编码愉快!