MacOS应用中NavigationList默认选中首项但无法渲染对应内容的问题排查

你遇到的核心问题是：单纯设置List的selection只是改变了列表项的选中样式，但并没有触发NavigationLink的导航逻辑——NavigationLink有自己独立的内部激活状态，和List的选中视觉效果是分开的。你只是让第一个条目看起来被选中了，但系统并没有执行导航到对应BoardView的操作。

下面给你两种针对性的解决方案，适配不同系统版本：

方案1：适配macOS 13+/iOS 16+（推荐使用NavigationStack） #

如果你使用的是较新的系统版本，建议迁移到NavigationStack，它的selection机制更直观且可靠：

@FetchRequest(
    sortDescriptors: [NSSortDescriptor(keyPath: \Board.timestamp, ascending: true)],
    animation: .default
)
private var boards: FetchedResults<Board>
@State var selectedBoard: Board?

var body: some View {
    NavigationStack(path: $selectedBoard) {
        List(boards, id: \.self, selection: $selectedBoard) { board in
            NavigationLink(value: board) {
                Text(board.name!)
            }
        }
        .listStyle(.sidebar)
        .navigationDestination(for: Board.self) { board in
            BoardView(board: board)
        }
        .onAppear {
            if selectedBoard == nil, let firstBoard = boards.first {
                selectedBoard = firstBoard
            }
        }
    }
}

这里NavigationStack的path直接绑定到selectedBoard，当你在onAppear中设置选中第一个条目时，系统会自动匹配对应的navigationDestination渲染视图，同时List的选中状态也会同步更新。

方案2：兼容旧版本（利用NavigationView的selection参数） #

如果需要兼容macOS 12及以下版本，可以直接让NavigationView的selection控制右侧视图，不需要依赖NavigationLink的跳转逻辑：

@FetchRequest(
    sortDescriptors: [NSSortDescriptor(keyPath: \Board.timestamp, ascending: true)],
    animation: .default
)
private var boards: FetchedResults<Board>
@State var selectedBoard: Board?

var body: some View {
    NavigationView(selection: $selectedBoard) {
        List(boards, id: \.self, selection: $selectedBoard) { board in
            Text(board.name!)
                .tag(board)
        }
        .listStyle(.sidebar)
        .onAppear {
            if selectedBoard == nil, let firstBoard = boards.first {
                selectedBoard = firstBoard
            }
        }
        
        // 右侧内容区域：根据选中项直接渲染
        if let board = selectedBoard {
            BoardView(board: board)
        } else {
            Text("请选择一个看板") // 可选：无选中项时的占位视图
        }
    }
}

这个方案中，NavigationView的selection直接关联右侧显示的内容，当selectedBoard被设置为第一个条目时，右侧会立刻渲染对应的BoardView，完全不需要手动点击触发。

原代码失效的原因 #

在你的原实现里，List的selection仅负责控制列表项的选中样式，而NavigationLink的激活状态并没有和selectedBoard绑定。只有用户手动点击NavigationLink时，才会触发导航并更新右侧视图；通过onAppear设置selectedBoard，只是改变了视觉选中状态，并没有触发NavigationLink的导航逻辑，所以右侧没有内容。

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