SwiftUI macOS应用卡顿排查：Instruments无法定位代码问题求助

1. 确保使用Debug配置编译 #

• 必须用Debug scheme运行应用，Release配置默认开启代码优化（如-O），会剥离符号，导致Instruments无法映射到你的源代码。
• 检查Xcode顶部scheme选择器，确认当前是Debug模式，而非Release。

2. 开启符号化相关编译设置 #

• 在Xcode项目的Build Settings中：
  • 搜索Debug Information Format，Debug配置下设置为DWARF with dSYM File（必须保留dSYM，否则符号无法被解析）；Release配置若需排查可临时修改，排查后改回默认避免包体积增大。
  • 搜索Strip Debug Symbols During Copy，确保Debug配置设为NO；搜索Strip Style，Debug配置选Non-Global Symbols或Debugging Symbols。

3. 配置Instruments的符号化选项 #

• 打开Instruments后，点击顶部菜单栏Instruments > Settings > Symbols：
  • 勾选Automatically download symbols，确保Apple系统框架的符号能被解析；
  • 若应用的dSYM未被自动识别，可右键左侧面板的应用名称，选择Add Symbol File，手动指向项目DerivedData目录下的dSYM文件。

4. 选择正确的模板并配置显示选项 #

• 排查卡顿优先用Time Profiler模板，它能直接捕获CPU调用栈，更易定位代码瓶颈：
  • 启动Time Profiler后点击Record，操作应用触发卡顿；
  • 停止记录后，在左侧Call Tree面板勾选以下选项：
    • Separate by Thread：区分不同线程调用，SwiftUI的UI更新通常在主线程；
    • Invert Call Tree：让调用栈从你的代码开始往上显示，更直观；
    • Hide System Libraries：过滤系统框架调用，只显示项目代码；
    • Flatten Recursion：合并递归调用的栈信息，避免冗余。

5. 针对SwiftUI的特殊排查技巧 #

• SwiftUI的卡顿可能来自body计算过慢、状态频繁触发重绘，或onAppear/task中的同步阻塞操作：
  • 若Time Profiler中仅显示SwiftUI内部方法，可在代码中添加自定义符号标记：

    func expensiveOperation() {
        os_signpost(.begin, log: .default, name: "Expensive Operation")
        // 耗时代码逻辑
        os_signpost(.end, log: .default, name: "Expensive Operation")
    }
    

    然后在Instruments中添加Signposts模板，直接查看这段代码的耗时。

6. 清理重建项目 #

• 若DerivedData缓存导致符号异常，执行Product > Clean Build Folder（快捷键Shift+Command+K），重新编译运行应用后再启动Instruments追踪。

内容的提问来源于stack exchange，提问作者Vincent