NavigationSplitView导航目标切换失效问题排查及解决

1. Hashable协议缺失：.navigationDestination(for:)要求绑定的数据类型必须遵守Hashable协议——SwiftUI需要通过哈希值匹配导航目标与对应数据。你遇到的AnyView不符合Hashable错误，大概率是因为尝试用AnyView或未正确实现Hashable的包装类型（比如未遵守协议的自定义枚举/任意类型）作为导航值。
2. 导航目标匹配失败：如果没有为每种Item类型单独注册.navigationDestination，或用错误的统一类型包装导致SwiftUI无法识别对应目标，就会出现跳转失效的情况。

方案一：为每种Item类型单独注册导航目标 #

适合Item类型独立、不需要统一管理选中状态的场景：

// 定义三种遵守Hashable的Item结构体（Swift值类型默认遵守，只要成员都符合要求）
struct ItemA: Hashable {
    let id: UUID = UUID()
    let title: String
}

struct ItemB: Hashable {
    let id: UUID = UUID()
    let content: String
}

struct ItemC: Hashable {
    let id: UUID = UUID()
    let count: Int
}

// 对应详情页视图
struct DetailViewA: View {
    let item: ItemA
    var body: some View {
        Text("Detail A: \(item.title)")
    }
}

struct DetailViewB: View {
    let item: ItemB
    var body: some View {
        Text("Detail B: \(item.content)")
    }
}

struct DetailViewC: View {
    let item: ItemC
    var body: some View {
        Text("Detail C: \(item.count)")
    }
}

// 主导航视图
struct MyNavigationView: View {
    @State private var selectedItem: AnyHashable?
    
    var body: some View {
        NavigationSplitView {
            List {
                NavigationLink("Go to Item A", value: ItemA(title: "First Item A"))
                NavigationLink("Go to Item B", value: ItemB(content: "Hello Item B"))
                NavigationLink("Go to Item C", value: ItemC(count: 42))
            }
        } detail: {
            selectedItem == nil ? Text("Select an item from the list") : EmptyView()
        }
        // 为每种Item类型单独注册导航目标
        .navigationDestination(for: ItemA.self) { item in
            DetailViewA(item: item)
        }
        .navigationDestination(for: ItemB.self) { item in
            DetailViewB(item: item)
        }
        .navigationDestination(for: ItemC.self) { item in
            DetailViewC(item: item)
        }
    }
}

方案二：用枚举统一包装所有Item类型 #

适合需要统一管理选中状态、集中处理导航逻辑的场景：

// 用枚举统一包装所有Item类型，确保枚举遵守Hashable
enum AppItem: Hashable {
    case a(ItemA)
    case b(ItemB)
    case c(ItemC)
}

struct MyNavigationView: View {
    @State private var selectedItem: AppItem?
    
    var body: some View {
        NavigationSplitView {
            List {
                NavigationLink("Go to Item A", value: AppItem.a(ItemA(title: "First Item A")))
                NavigationLink("Go to Item B", value: AppItem.b(ItemB(content: "Hello Item B")))
                NavigationLink("Go to Item C", value: AppItem.c(ItemC(count: 42)))
            }
        } detail: {
            Text("Select an item from the list")
        }
        // 注册枚举类型的导航目标，通过switch匹配返回对应详情页
        .navigationDestination(for: AppItem.self) { item in
            switch item {
            case .a(let itemA):
                DetailViewA(item: itemA)
            case .b(let itemB):
                DetailViewB(item: itemB)
            case .c(let itemC):
                DetailViewC(item: itemC)
            }
        }
    }
}

• 所有绑定给NavigationLink的value类型，必须有对应的.navigationDestination(for:)注册，否则跳转无效。
• 若使用枚举包装，需确保枚举的所有关联值类型都遵守Hashable（枚举遵守Hashable的前提是关联值类型符合要求）。
• 避免用Any或AnyView作为导航值类型，除非手动实现Hashable（不推荐，易引发匹配错误）。

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