場景復現

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

1. 確認只有一個穩定版本 Xcode

   sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
   xcodebuild -version
   lldb -v          # 兩者版本號必須一致
   

2. 暫時屏蔽 shell 個性化配置

   mv ~/.zprofile ~/.zprofile.bak
   mv ~/.zshrc    ~/.zshrc.bak
   

   然后重啟 Xcode 再試。如果錯誤消失，逐條恢復配置找出罪魁禍首（常見是修改 PATH 或自定義別名把 /usr/bin/clang 蓋掉）。

3. 清理派生數據與模塊緩存
   Xcode → Settings → Locations → Derived Data → Delete。
   同時刪除 ~/Library/Developer/Xcode/ModuleCache.

4. 確認項目能用 Clang 單獨編譯
   從終端跑 xcodebuild clean build，如果 C/Obj-C 頭文件報錯，需要先解決編譯問題。

5. 重裝/更新命令行工具

   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 環境驗證，往往就能定位并排除問題。