跳到主要内容

swift

欢迎使用 Cursor 进行 Swift 开发！无论您正在构建 iOS 应用、macOS 应用程序还是服务端 Swift 项目，我们都能为您提供支持。本指南将帮助您在 Cursor 中设置 Swift 开发环境，从基础配置开始逐步介绍高级功能。

基础工作流程​

在 Cursor 中使用 Swift 的最简单方式，是将其作为主要代码编辑器，同时继续依赖 Xcode 进行应用的构建和运行。您将获得以下强大功能：

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

当需要构建或运行应用时，只需切换至 Xcode 即可。这种工作流程非常适合那些希望利用 Cursor 的 AI 功能，同时继续使用熟悉的 Xcode 工具进行调试和部署的开发者。

热重载​

当使用 Xcode 工作区或项目（而非直接在 Xcode 中打开文件夹）时，Xcode 经常会忽略你在 Cursor 中或外部对文件所做的更改。

虽然你可以通过直接在 Xcode 中打开文件夹来解决此问题，但在 Swift 开发工作流中可能仍需使用项目文件。

推荐使用 Inject 作为解决方案，这是一个 Swift 热重载库，能让你的应用在代码修改后立即"热重载"并更新。该方案有效规避了 Xcode 工作区/项目问题的副作用，允许你在 Cursor 中修改代码后立即在应用中看到变更效果。

Inject - Swift 热重载深入了解 Inject 并在你的 Swift 项目中使用它。

最佳实践

使用 Inject 时：

  • 确保项目已配置 Swift Package Manager
  • 在 AppDelegate 中添加 import Inject
  • 通过 @ObservedObject private var iO = Inject.observer 启用观察模式

高级 Swift 开发​

💡 本指南章节深受 Thomas Ricouard 关于使用 Cursor 进行 iOS 开发的文章启发。请查阅他的文章获取更多细节，并关注他获取更多 Swift 相关内容。

若您希望仅需保持一个编辑器开启状态，并避免在 Xcode 与 Cursor 之间频繁切换，可以使用 Sweetpad 等扩展工具，将 Cursor 直接集成至 Xcode 的底层构建系统。

Sweetpad 是一个强大的扩展，可让您在 Cursor 中直接构建、运行和调试 Swift 项目，同时完整保留 Xcode 的核心功能。

要开始使用 Sweetpad，您仍需在 Mac 上安装 Xcode —— 这是 Swift 开发的基石。您可通过 Mac App Store 下载 Xcode。完成 Xcode 安装后，让我们通过几个必备工具来增强您在 Cursor 中的开发体验。

打开终端并运行以下命令：

code]:pr-[3rem] [&_pre>code>span.line-highlight]:min-w-[calc(100%+3rem)] [&_pre>code>span.line-diff]:min-w-[calc(100%+3rem)] rounded-2xl bg-white overflow-x-auto scrollbar-thin scrollbar-thumb-rounded scrollbar-thumb-black/15 hover:scrollbar-thumb-black/20 active:scrollbar-thumb-black/20 dark:scrollbar-thumb-white/20 dark:hover:scrollbar-thumb-white/25 dark:active:scrollbar-thumb-white/25" component-part="code-block-root" style="font-variant-ligatures: none; height: auto;">

# 无需开启 Xcode 即可构建项目
brew install xcode-build-server

# 将 xcodebuild 命令输出美化至 Cursor 终端
brew install xcbeautify

# 提供高级代码格式化和语言特性支持
brew install swiftformat

接下来，在 Cursor 中安装 Swift 语言支持扩展，该扩展将为您提供开箱即用的语法高亮和基础语言功能支持。

最后安装 Sweetpad 扩展以实现 Cursor 与 Xcode 的集成。Sweetpad 封装了针对 xcodebuild CLI 的快捷操作（以及更多功能），允许您像在 Xcode 中一样扫描构建目标、选择运行设备、构建并运行应用。此外，它还会为您的项目配置 Xcode 构建服务器，从而完整支持上述所有功能。

Sweetpad 使用指南​

安装 Sweetpad 并已在 Cursor 中打开 Swift 项目后，您需要首先执行 Sweetpad: Generate Build Server Config 命令。该命令会在项目根目录生成 buildServer.json 配置文件，使 Xcode 构建服务器能够正常运作。

随后，您可以通过以下两种方式选择要构建和运行的目标：

  1. 使用命令面板（Command Palette）
  2. 通过 Sweetpad 侧边栏

💡 需要先执行一次项目构建才能启用自动补全、跳转到定义等语言功能。

现在您还可以按下 F5 键启动带调试器的构建运行流程。首次使用时可能需要创建启动配置，当系统提示时请从列表中选择 Sweetpad 即可！

与 Cursor 中众多扩展一样，您可以将 Sweetpad 的常用命令绑定到键盘快捷键，从而显著提升工作效率。

如需深入了解 Sweetpad，请参考以下资源：

Sweetpad 官网 包含功能说明与安装指南的官方网站

Sweetpad 使用手册 涵盖配置方法、使用技巧与高级功能的完整指南