欢迎来到 Cursor 的 Swift 开发!无论你要构建 iOS 应用、macOS 应用,还是服务端 Swift 项目,我们都能帮上忙。本指南将带你在 Cursor 中完成 Swift 开发环境的设置,从基础入门到进阶功能逐步展开。

基本工作流

使用 Cursor 搭配 Swift 的最简单方式,是把它当作你的主力代码编辑器,同时继续用 Xcode 来构建和运行应用。你会获得这些强大功能:
  • 智能代码补全
  • AI 驱动的编码助手(在任意一行试试 CMD+K
  • 使用 @Docs 快速查阅文档
  • 语法高亮
  • 基础代码导航
当你需要构建或运行应用时,只需切换到 Xcode。这个工作流非常适合想要利用 Cursor 的 AI 能力、同时在调试和部署上仍使用熟悉的 Xcode 工具的开发者。

热重载

当使用 Xcode 的 workspace 或 project(而不是在 Xcode 中直接打开文件夹)时,Xcode 往往会忽略你在 Cursor 中或总体上在 Xcode 之外对文件所做的更改。 虽然你可以在 Xcode 中直接打开该文件夹来规避这个问题,但在 Swift 的开发工作流中,你可能需要使用 project。 一个很好的解决方案是使用 Inject,这是一个用于 Swift 的热重载库,允许你的应用在发生更改后立即“热重载”并实时更新。它不受 Xcode workspace/project 问题的副作用影响,让你在 Cursor 中所做的更改可以立即体现在应用中。

高阶 Swift 开发

本指南这一部分深受 Thomas Ricouard 及其 文章 的启发,内容讲述如何在 iOS 开发中使用 Cursor。想了解更多细节可以去读他的文章,也别忘了关注他获取更多 Swift 内容。
如果你想只开一个编辑器,避免在 Xcode 和 Cursor 之间来回切换,可以用 Sweetpad 这类扩展,把 Cursor 直接接入 Xcode 的底层构建系统。 Sweetpad 是一个功能强大的扩展,它让你可以在 Cursor 中直接构建、运行、调试 Swift 项目,同时不牺牲 Xcode 的能力。 开始使用 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、选择运行目标、构建并运行应用。除此之外,它还会为 Xcode Build Server 配置你的项目,让你获得上面提到的全部功能。

Sweetpad 用法

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