欢迎在 Cursor 中进行 Swift 开发!不管是构建 iOS 应用、macOS 应用,还是服务端 Swift 项目,我们都能帮上忙。本指南会带你在 Cursor 中设置 Swift 开发环境,从基础入门,到进阶功能逐步深入。

基本工作流

在 Swift 开发里,最简单的用法是把 Cursor 当作主力代码编辑器,同时继续用 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 中。

高级 Swift 开发

本指南的这一部分深受 Thomas Ricouard 及其关于在 iOS 开发中使用 Cursor 的 文章 启发。想了解更多细节,请查看他的文章,并关注他获取更多 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 一样扫描目标、选择运行目标、构建并运行应用。除此之外,它还会为 Xcode Build Server 配置你的项目,这样你就能获得上面提到的所有特性。

Sweetpad 使用

安装好 Sweetpad,并在 Cursor 中打开一个 Swift 项目后,先运行 Sweetpad: Generate Build Server Config 命令。它会在项目根目录生成一个 buildServer.json 文件,使 Xcode Build Server 能与项目协同工作。 接着,你可以在命令面板或 Sweetpad 侧边栏中选择要构建和运行的目标。
需要先构建一次项目,才能启用自动补全、跳转到定义等语言功能。
现在也可以直接按 F5 带调试器构建并运行项目——可能需要先创建一个启动配置,但在提示时从列表中选择 Sweetpad 就行! 和 Cursor 的很多扩展一样,你可以把不少 Sweetpad 命令绑定到键盘快捷键上,让你的工作流更高效。 想进一步了解 Sweetpad,查看这些资源: