在 VS Code 里写 Swift 并运行到 iPhone，需要一台装好 Xcode 的 Mac，再在 VS Code 里装一个免费插件快蝎（KXApp）。装好后打开你的 Xcode 工程，就有 Swift 代码补全；按 ⌘R 构建并运行到模拟器或 iPhone，断点停下时可以看变量。这篇按实际顺序走一遍：从安装插件、打开工程、写代码，到在模拟器和 iPhone 上运行调试，最后在 VS Code 里改 Info.plist 和 App 图标。以下内容截至 2026 年 10 月，适用 Xcode 16 及以上。
开始前准备：Mac 上已安装 Xcode 并打开过一次（完成附加组件安装），终端运行 xcode-select -p 输出在 Xcode.app 里面。还没装插件的按安装页操作。
第一步：安装插件
在 VS Code 的扩展视图（⌘⇧X）搜索 kxapp，安装「快蝎」。用 Cursor 的同样在扩展视图里搜索安装（来自 Open VSX）。
第二步：打开 Xcode 工程
用「文件 › 打开文件夹…」打开含有 .xcodeproj 或 .xcworkspace 的目录。识别到工程后：
- 左侧活动栏出现 Xcode 工程 视图，列出 Scheme、构建配置、运行目标、设备与模拟器。
- 底部状态栏出现 Scheme、运行目标和构建按钮。
用 CocoaPods 的工程会自动选 .xcworkspace。工程不需要转换，同事继续用 Xcode 打开同一个工程不受影响。
第三步：写 Swift，代码补全开箱即用
打开任意 .swift 文件，输入 . 就会出现补全列表；按 F12 跳到定义，鼠标悬停看文档，错误实时标红。SwiftUI、Objective-C 也一样。
第一次打开工程时，插件会在后台构建一次，Swift Package、CocoaPods 等第三方库的补全要等这次构建完成，通常几秒到一两分钟。之后补全按当前 Scheme 和运行设备计算，结果和在 Xcode 里写代码时一致。补全不出现时的排查见代码补全指南。
第四步：运行到模拟器
- 点状态栏的 Scheme，选要运行的 App。
- 点运行目标，选一台模拟器（没启动的会自动启动）。
- 按 ⌘R。插件依次构建、安装、启动 App，并接上调试器。
编译错误进「问题」面板，点一条跳到对应的行。App 里的 print 输出在「输出 › kxapp Console」。
第五步：运行到 iPhone
用数据线连上 iPhone，在运行目标里选它，再按 ⌘R。第一次用这台手机要先完成下面几件事，和用 Xcode 时一样：
| 要做的事 | 在哪里做 |
|---|---|
| 解锁手机，点「信任此电脑」 | iPhone 弹窗 |
| 打开开发者模式（iOS 16 及以上），按提示重启 | iPhone「设置 › 隐私与安全性 › 开发者模式」 |
| 登录 Apple ID，工程使用自动签名 | Xcode「Xcode › Settings… › Accounts」（账户）；target 的 Signing & Capabilities 选好 Team |
| 让 Xcode 准备一次这台设备 | Xcode「Window › Devices and Simulators」里连一次手机 |
完成后，之后每次改完代码按 ⌘R，新版本直接装到手机上启动（还在调试时先按 ⌘. 停止再按）。真机运行的更多细节见iPhone 真机运行与调试。
第六步：打断点调试
在行号左侧点一下设断点，按 ⌘R。断点命中后，左侧调试视图里能看变量、调用栈和线程；在调试控制台输入 po self 打印对象。条件断点、日志断点（不停下、只输出一行）也都能用。按 ⌘. 停止。
第七步：改 Info.plist、App 图标和多语言
这些平时要回 Xcode 改的文件，在 VS Code 里直接打开就是可视化编辑器：
Info.plist、.entitlements、隐私清单：按 Xcode 的样子显示键和类型，可以增删行。Assets.xcassets：右键 AppIcon，用一张 1024×1024 图片填满全部尺寸。.xcstrings：按语言分列编辑翻译，支持复数。- 工程设置：General 和 Build Settings，能看到每一层的值。
用法见可视化编辑器指南。Interface Builder、Instruments、归档上传仍在 Xcode 里做，工程是同一个，随时可以切过去。
常见问题
用 VS Code 写 Swift 还需要装 Xcode 吗？
需要。插件用 Mac 上已安装的 Xcode 来构建、签名和调试，所以结果和 Xcode 一致。装好之后，日常写代码、运行和调试都可以只开 VS Code。
Windows 上能用 VS Code 写 Swift 运行到 iPhone 吗？
这个插件只支持 Mac。它依赖本机的 Xcode 完成构建、签名和安装。
快蝎插件收费吗？
免费，不需要注册账号，所有功能都能直接用。
Cursor 里能用吗？
能。Cursor、Windsurf、VSCodium 在扩展视图搜索 kxapp 安装即可，用法相同。
按 ⌘R 没反应怎么办？
⌘R 只在编辑器有焦点、打开了 Xcode 工程、并且当前没有在调试时生效。先点一下代码编辑区再按；调试进行中先按 ⌘. 停止再按 ⌘R。也可以点 Xcode 工程视图标题栏上的「构建并运行」按钮（状态栏上的扳手图标是「构建」，只编译不运行）。