跳到主要内容
本页目录

VS Code 开发 iOS App 常见报错怎么解决?构建失败和 No such module

项目没识别、构建或签名失败、真机运行失败、没有补全、工程设置保存不了时怎么办。

最后更新

VS Code 开发 iOS App 报错时,先看 KXApp(快蝎)的三个日志通道,都在「输出」面板右上角的下拉框里:kxapp(插件本身)、kxapp Build(构建)、kxapp Console(App 输出)。下面按现象列出工程视图不出现、构建失败、真机运行失败、没有补全和工程设置保存不了的处理办法;都不管用时,把这三个通道的内容附在 GitHub issue 里。

为什么没有出现 Xcode 工程视图?

  • 打开的文件夹里要有 .xcodeproj 或 .xcworkspace;node_modules、Pods、build、DerivedData 目录下的工程不会被识别。
  • 运行 xcode-select -p,输出应在 Xcode.app 里面;是 CommandLineTools 时运行 sudo xcode-select -s /Applications/Xcode.app。
  • 新装的 Xcode 要先打开一次,完成附加组件安装并同意许可协议。

iOS App 构建失败怎么办?

  • 先看「问题」面板和「输出 › kxapp Build」里第一条错误。同样的工程在 Xcode 里能不能构建成功,可以帮助判断问题在工程还是在插件。
  • 签名错误(No profiles for…、Signing requires a development team):在 Xcode「设置 › 账户」登录 Apple ID,并在 target 的 Signing & Capabilities 里选好 Team。
  • CocoaPods 工程报找不到模块:确认用的是 .xcworkspace,并且执行过 pod install。
  • 怀疑有旧产物:用「清理构建目录」后重新构建。

iOS 真机调试或运行失败怎么办?

现象处理
设备列表里没有手机换一根数据线或 USB 口,解锁手机并点「信任」,再点「刷新设备」
设备后面标着开发者模式未打开手机「设置 › 隐私与安全性 › 开发者模式」打开后重启
The device is locked解锁手机后重新运行
很久停不到断点,弹出「设备未准备好」打开 Xcode 的 Window › Devices and Simulators,连一次这台设备,等它准备完成
App 闪退、调试器连不上看「输出 › kxapp Console」里 App 的最后输出;在 Xcode 里运行确认是不是 App 本身的问题

没有补全或报 No such module 怎么办?

  • 依赖包和 Pods 要构建过才有补全。等几秒后台构建完成,或手动 Cmd+B 一次。
  • 工作区根目录的 buildServer.json 属于其他构建服务器时,插件不会接管。删掉它后重新打开窗口。
  • 仍然不对时运行「kxapp: 重启代码提示」或「kxapp: 重建项目索引」。
  • 装了 clangd 等其他 C / Objective-C 语言扩展时,两个扩展会同时给出结果。停用其中一个,或在 kxapp.swiftSourcekitLspSupportedLanguages 里去掉对应语言。

补全的工作方式和相关设置见VS Code Swift 代码补全。

工程设置保存不了怎么办?

写入 project.pbxproj 需要 Ruby 的 xcodeproj gem。在终端运行 ruby -e 'require "xcodeproj"' 报错时,运行命令「安装 xcodeproj Ruby gem」,或执行 gem install --user-install xcodeproj。用 rbenv、rvm 等管理 Ruby 时,把对应 ruby 的路径填进设置 kxapp.rubyPath。

按上面的办法处理后,VS Code 开发 iOS App 报错仍然没有解决,就把 kxapp、kxapp Build、kxapp Console 三个通道的内容附在 GitHub issue 里,并写明 Xcode 版本和出错的步骤。

常见问题

快蝎支持哪些 Xcode 版本?

支持 Xcode 16 及以上,需要装在 Mac 上并至少打开过一次。新装的 Xcode 要先完成附加组件安装并同意许可协议。

Xcode 里能构建,VS Code 里不行,先查什么?

先运行 xcode-select -p,确认它指向你在用的 Xcode.app,而不是 CommandLineTools;再对照「输出 › kxapp Build」里的第一条错误。

真机构建时描述文件会自动创建吗?

会,设置 kxapp.build.allowProvisioningUpdates 默认开,真机构建时让 Xcode 自动创建或更新描述文件。前提是已在 Xcode「设置 › 账户」登录 Apple ID 并选好 Team。

CocoaPods 工程找不到模块怎么办?

确认打开的是 .xcworkspace,并且在工程目录执行过 pod install,然后按 Cmd+B 构建一次,Pods 就有补全了。

接下来

相关教程