解决 Cannot create Swift scratch context
场景复现
Xcode 控制台输出：
Cannot create Swift scratch context (couldn't create a Clang Importer)
Analysis 分析
发生了什么？
在调试 Swift 代码或在 LLDB 里执行 po/expr 命令时，LLDB 需要为表达式临时创建一份 “Swift scratch context”。
这一步会调用 ClangImporter 去加载您的 C／Objective-C 头文件、模块缓存及 SDK。
如果 ClangImporter 无法正确初始化，LLDB 就会抛出：
Cannot create Swift scratch context
(couldn't create a Clang Importer)
结果是所有 Swift 表达式求值都失效。(developer.apple.com, ulog.sugiy.com)
常见根因
| 排名 | 根因 | 典型表现／线索 |
|---|---|---|
| ① | 调试器与编译器版本不匹配（系统装了多个 Xcode，或 xcode-select 指向旧版本命令行工具） | 只要切到正确的 Xcode 路径就恢复正常(stackoverflow.com) |
| ② | 自定义 Shell 环境破坏了 LLDB 启动（Homebrew 版 zsh/bash、PATH 被改写、别名覆盖了 clang） | 新建一个“干净”的 macOS 用户帐户就不会复现(forums.kodeco.com, developer.apple.com) |
| ③ | SDK / Header 路径或 Bridging Header 出错（缺文件、大小写不一致、非法 C 宏） | 清理 Derived Data 后第一次求值能成功，随后又失败，或仅在混编项目出现 |
| ④ | 破损的模块缓存 / LLDB 状态 | 删除 ~/Library/Developer/Xcode/DerivedData、~/.lldb 后短暂恢复 |
快速自检 Checklist
-
确认只有一个稳定版本 Xcode
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer xcodebuild -version lldb -v # 两者版本号必须一致 -
暂时屏蔽 shell 个性化配置
mv ~/.zprofile ~/.zprofile.bak mv ~/.zshrc ~/.zshrc.bak然后重启 Xcode 再试。如果错误消失，逐条恢复配置找出罪魁祸首（常见是修改
PATH或自定义别名把/usr/bin/clang盖掉）。 -
清理派生数据与模块缓存
Xcode → Settings → Locations → Derived Data →Delete。
同时删除~/Library/Developer/Xcode/ModuleCache. -
确认项目能用 Clang 单独编译
从终端跑xcodebuild clean build，如果 C/Obj-C 头文件报错，需要先解决编译问题。 -
重装/更新命令行工具
xcode-select --install
经验修复方案
| 场景 | 解决办法 |
|---|---|
| Mac 上有 多个 Xcode 或装了 beta | 卸载多余版本；或每次运行前 sudo xcode-select -s 到正确路径 |
Homebrew 把 /opt/homebrew/bin 放在 PATH 前面 | 把 /usr/bin 提到最前，确保系统自带 clang 优先 |
| 使用 自编译 LLVM/Clang | 调试时禁用；或在 .lldbinit 里 settings set target.swift-auto-import-clang-modules false 看是否缓解 |
| 出错仅在 混编巨型项目 | 尝试把桥接头拆分成多个模块；或在 Build Settings 打开 CLANG_ENABLE_MODULES = YES |
一句话总结
90% 的 “Cannot create Swift scratch context (couldn’t create a Clang Importer)” 都是 工具链或环境变量被篡改 导致的。
先匹配好 Xcode/Lldb，再用干净的 shell 环境验证，往往就能定位并排除问题。