VS Code / Cursor 里 Xcode 工程没有代码补全？原因和解决办法 - 快蝎

Q: 需要另装 xcode-build-server 吗？

不需要。快蝎插件自带补全所需的服务，打开工程就能用。项目里已有 xcode-build-server 生成的 buildServer.json 时，插件不会动它；想改用快蝎的补全，删掉这个文件后重新加载窗口。

Q: buildServer.json 要提交到 Git 吗？

不用。它是插件在本机生成的，可以加进 .gitignore。

用 VS Code 或 Cursor 打开 Xcode 工程（.xcodeproj / .xcworkspace）后没有代码补全、跳转不到定义、满屏「No such module」，通常是因为编辑器拿不到工程的编译设置：它不知道每个文件用哪个 SDK、哪些编译参数、第三方库在哪里。装上免费插件快蝎（KXApp）后，打开工程就会自动接上这些设置，补全和跳转的结果和在 Xcode 里一致；第三方库构建过一次后也有补全。这篇先讲原因，再给出按现象排查的办法，截至 2026 年 10 月，适用 Xcode 16 及以上。

开始前准备：Mac 上已安装 Xcode 并打开过一次，终端运行 xcode-select -p 输出在 Xcode.app 里面。还没装插件的按安装页操作。

为什么 Xcode 工程在 VS Code 里没有补全

Swift 和 Objective-C 的补全要知道「这个文件是怎么编译的」：目标平台、SDK、编译选项、依赖库的路径。这些信息存在 Xcode 工程和构建产物里。

打开方式	Swift Package 项目	Xcode 工程（.xcodeproj / .xcworkspace）
只装 VS Code 官方 Swift 扩展	补全完整	拿不到工程的编译设置，常见补全不全、跳转找不到符号、「No such module」
VS Code / Cursor + 快蝎插件	—	按当前 Scheme、构建配置和运行设备读取工程设置，补全与 Xcode 一致

所以问题不在 VS Code 本身，而在于有没有东西把 Xcode 工程的编译设置交给编辑器。

用快蝎插件开启补全

在扩展视图（⌘⇧X）搜索 kxapp 安装插件。Cursor 用户同样在扩展视图里搜索安装。
用「文件 › 打开文件夹…」打开含 .xcodeproj 或 .xcworkspace 的目录。
等几秒。插件会在打开的文件夹根目录放一个 buildServer.json（代码补全要靠它，可以加进 .gitignore）；工程还没构建过时，插件会在后台自动构建一次，让 Swift Package、CocoaPods 等第三方库也有补全。
打开任意 .swift 文件，输入 . 看补全列表，按 F12 跳到定义。

之后补全按当前选中的 Scheme、构建配置和运行设备计算，在状态栏切换后自动更新。Swift、SwiftUI、Objective-C、C、C++ 都支持补全、跳转定义、悬停文档、查找引用和实时报错。

按现象排查

现象	原因	处理
第三方库（Swift Package、Pods）报「No such module」	依赖还没构建过	不用手动构建：插件会在后台自动构建一次，期间可能短暂提示，完成后自动消失；大工程后台构建时间更长，也可以按 ⌘B 构建一次
CocoaPods 工程找不到模块	打开的是 .xcodeproj，或没执行过 `pod install`	确认用的是 `.xcworkspace` 并执行过 `pod install`；同名的工作区和工程同时存在时插件会自动选工作区
完全没有补全，打开的文件夹根目录已有别人的 `buildServer.json`	这个文件属于其他工具（如 xcode-build-server），插件不会覆盖它	删掉这个 `buildServer.json`，再执行「开发人员: 重新加载窗口」
补全卡住、报错明显过期	代码提示服务状态不对	命令面板运行「kxapp: 重启代码提示」
跳转或查找引用找不到明明存在的符号	索引不完整	命令面板运行「kxapp: 重建项目索引」
同一处出现两份补全或两份报错	同时装了 clangd 等 C / Objective-C 语言扩展	停用其中一个，或在设置 `kxapp.swiftSourcekitLspSupportedLanguages` 里去掉对应语言
`.h` 文件里 Objective-C 语法高亮不对	VS Code 默认把 `.h` 当成 C++	在设置里加 `"files.associations": { "*.h": "objective-c" }`（补全不受影响）
切换 Scheme 或运行设备后补全不对	补全按当前选择计算	稍等自动更新；仍不对时运行「kxapp: 重启代码提示」
没有出现 Xcode 工程视图	没识别到工程，或 `xcode-select` 指向了命令行工具	确认文件夹里有工程（Pods、build、DerivedData 下的不算）；运行 `sudo xcode-select -s /Applications/Xcode.app`

仍然不行时，把「输出」面板里 kxapp、kxapp Build 两个通道的内容附在 GitHub issue 里。

设置	作用
`kxapp.build.prepareForCodeCompletion`	工程还没构建过时后台静默构建一次（默认开），不想要可以关掉
`kxapp.swiftSourcekitLspBackgroundIndexing`	后台索引：auto / on / off
`kxapp.swiftSourcekitLspSupportedLanguages`	由插件负责补全的语言，想让其他扩展处理 C / C++ 时从这里去掉
`kxapp.swiftPath`	换用别的 Swift 工具链，留空用 xcode-select 选中的 Xcode
`kxapp.swiftSourcekitLspDisable`	完全关掉代码补全

常见问题

需要另装 xcode-build-server 吗？

不需要。快蝎插件自带补全所需的服务，打开工程就能用。项目里已有 xcode-build-server 生成的 buildServer.json 时，插件不会动它；想改用快蝎的补全，删掉这个文件后重新加载窗口。

buildServer.json 要提交到 Git 吗？

不用。它是插件在本机生成的，可以加进 .gitignore。

第一次打开工程，补全要等多久？

通常几秒；依赖较多的工程要等后台构建完成，第三方库才有补全。你手动构建时，后台构建会立即让路。

Cursor 里也能这样用吗？

能。Cursor 在扩展视图搜索 kxapp 安装，打开 Xcode 工程后补全和跳转与 VS Code 相同。