SwiftUI Debugging 是一个面向 SwiftUI 开发者的诊断技能，用于排查视图更新、预览崩溃和布局异常三类问题。其核心原则是：从可观察的症状出发，系统性地测试并逐一排除原因，而不是凭猜测修改代码。
用途 当视图没有按预期更新、预览崩溃或无法加载、布局在特定设备上显示异常，或者你倾向于用 @ObservedObject 到处打补丁时，可以使用本技能。如果应用在运行时崩溃（非预览）、构建完全失败或需要环境诊断，应改用 axiom-xcode-debugging；如果涉及 async/await、MainActor 或数据竞争警告，应改用 axiom-swift-concurrency。
主要能力 技能将 SwiftUI 调试分为三类，每类都有对应的诊断决策树：
- 视图不更新：通过决策树判断问题属于结构体副本变更、绑定标识丢失、意外视图重建、缺少观察者模式，还是 @ViewBuilder 闭包重新初始化。
- 预览崩溃：区分缺少依赖、状态初始化失败和 Xcode 缓存损坏三种根因。
- 布局问题：提供常见场景的快速参考模式。
调试工具 技能介绍了 Self._printChanges() 这一仅用于调试的方法，用于理解视图 body 被调用的原因。可在 LLDB 中通过 expression Self._printChanges() 调用，也可临时写入代码（发布前必须移除）。输出可区分 @self changed（视图值本身变化）、count changed（@State 属性触发更新）以及无输出（body 未被调用，视图未更新）。注意该方法以下划线开头，未来版本可能移除，且绝不可提交到 App Store。
视图不更新决策树 第一步：能否在最小预览中复现？能则问题在代码中，继续诊断；不能则可能是 Xcode 状态或缓存损坏，转至预览崩溃部分。
第二步：诊断根因，共五类：
- 根因 1：通过局部副本修改结构体。@State 属性包装器只能感知通过其自身 setter 的修改，对副本的修改不可见。修复方式是始终通过 @State 属性本身修改。
- 根因 2：绑定标识丢失。传入 .constant() 或每次渲染都新建绑定会破坏双向连接。修复方式是直接传递 $state；对 @Observable 对象（iOS 17+）使用 @Bindable；若需自定义绑定（iOS 17 之前），应在 init 中创建或缓存，而非在 body 中创建。
- 根因 3：意外视图重建。视图获得新标识（从条件分支移除、在容器中移动或容器本身被重建）会导致 @State 重置。修复方式是使用 .opacity() 代替条件分支，或用 .id() 提供稳定标识。
- 根因 4：缺少观察者模式。SwiftUI 不知道需要观察对象变化。iOS 17+ 使用 @Observable 宏配合 @State；iOS 17 之前使用 @StateObject（自有实例）、@ObservedObject（注入实例）或 @EnvironmentObject（跨树共享）。@Observable 的优势包括自动依赖追踪、无需 @Published、配合 @State 使用、可作为普通属性传递。
- 根因 5：@ViewBuilder 闭包重新初始化。在 .sheet、.fullScreenCover、.popover 或 NavigationStack destination 中，若将父级 @State 作为子视图 init 参数传入，且回调又修改同一状态，闭包会重新求值，导致子视图总是显示“已完成”状态、跳过加载动画。诊断方法是在父子视图中都加入 Self._printChanges()。修复方式（由简到繁）：不将可变状态回传为 init 参数；为显示逻辑与缓存使用不同的 @State；让子视图自行查询数据源。
预览崩溃决策树 第一步：判断错误类型。
- 错误类型 1：“Cannot find in scope”或“No such module”，根因是预览缺少必需依赖（@EnvironmentObject、@Environment、导入的模块）。修复方式是为预览提供依赖，如 .environmentObject(AppModel())，并检查缺失的导入。
- 错误类型 2：致命错误或静默崩溃（无错误信息），根因是运行时状态初始化失败，例如数组越界或可选值强制解包失败。
适用场景 适用于视图未按预期更新、预览崩溃或无法加载、布局在特定设备上异常，以及你正准备用 @ObservedObject 到处打补丁的情况。
限制 技能要求 Xcode 26+ 与 iOS 17+（iOS 14-16 的模式仍然有效，见相关说明）。Self._printChanges() 以下划线开头，未来版本可能移除，且绝不可提交到 App Store，仅限调试期间使用。关于布局问题的具体快速参考模式、预览崩溃中状态初始化失败的完整修复示例，以及相关技能（axiom-xcode-debugging、axiom-swift-concurrency、axiom-swiftui-performance、axiom-swiftui-layout）的详细内容，资料中未完整提供。