iOS & macOS (Swift)

使用 Xcode、热重载和 Sweetpad 工具,将 Cursor 集成到 Swift 开发工作流的指南

欢迎在 Cursor 中进行 Swift 开发!无论你是在构建 iOS 应用、macOS 应用,还是服务端 Swift 项目,这份指南都能帮助你从基础到进阶,配置好 Swift 开发环境。

基础工作流

最简单的方式是将 Cursor 作为你的主代码编辑器,同时继续使用 Xcode 来构建和运行应用。你将获得如下强大功能:

  • 智能代码补全
  • AI 驱动的编码辅助(在任意行试试 CMD+K)
  • 通过 @Docs 快速访问文档
  • 语法高亮
  • 基础代码导航

当你需要构建或运行应用时,只需切换到 Xcode。这种工作流非常适合希望利用 Cursor AI 能力,同时又习惯用 Xcode 进行调试和部署的开发者。

热重载

当你使用 Xcode 工作区或项目(而不是直接在 Xcode 中打开文件夹)时,Xcode 可能会忽略在 Cursor 或其他编辑器中做出的文件更改。

虽然你可以通过在 Xcode 中打开文件夹来解决,但在 Swift 开发中通常还是需要用到项目。

一个很好的解决方案是使用 Inject —— 这是一款 Swift 热重载库,可以让你的应用在代码变更后实时“热重载”并立即更新。这样你可以在 Cursor 中修改代码,并立刻在应用中看到效果,无需担心 Xcode 工作区/项目的副作用。

高级 Swift 开发

本节内容深受 Thomas Ricouard 及其关于在 Cursor 中进行 iOS 开发的文章启发。更多细节可参考原文。

如果你希望只用一个编辑器,无需在 Xcode 和 Cursor 之间切换,可以使用 Sweetpad 这类扩展,将 Cursor 直接与 Xcode 的底层构建系统集成。

Sweetpad 是一款强大的扩展,让你可以在 Cursor 中直接构建、运行和调试 Swift 项目,同时不影响 Xcode 的功能。

开始使用 Sweetpad,你仍需在 Mac 上安装 Xcode(Swift 开发的基础),可在 Mac App Store 下载。安装好 Xcode 后,按如下步骤提升 Cursor 的开发体验:

# Builds your projects without needing Xcode open
brew install xcode-build-server

# Pretty print's the `xcodebuild` command output into Cursor's terminal
brew install xcbeautify

# Allows for advanced formating and language features
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 资源: