SwiftUI中NavigationLink包裹的图片不显示问题求助

根据你描述的情况，当把Image放在NavigationLink里就不显示、移除后正常，大概率是视图布局约束、图片引用或导航组件兼容性的问题，下面是几个针对性的排查和解决方向：

1. 检查图片资源的引用正确性 #

首先确认group-\(set.purpose)生成的图片名称和你Asset Catalog里的资源完全匹配：

• 注意iOS图片名称区分大小写，别出现拼写错误
• 验证set.purpose的实际值是否符合预期（比如有没有空格、特殊字符导致名称拼接错误）
• 可以临时替换成一张确定存在的固定名称图片（比如Image("test-image")），测试是否能显示，排除名称拼接的问题

2. 修复Image的布局约束 #

你当前只给Image设置了height: 300，但没有设置宽度或比例约束，NavigationLink的容器可能会把图片压缩到不可见。试试调整Image的布局代码：

Image("group-\(set.purpose)")
    .resizable()
    .aspectRatio(contentMode: .fit) // 保持图片比例，避免拉伸或压缩
    .frame(height: 300) // 固定高度，宽度自适应

如果需要图片撑满宽度，可以用：

Image("group-\(set.purpose)")
    .resizable()
    .scaledToFill()
    .frame(height: 300)
    .clipped() // 裁剪超出部分

3. 确认ForEach的标识正确性 #

确保你的Set模型正确遵循了Identifiable协议，或者在ForEach中显式指定id参数：

// 假设你的Set模型结构，确保id是唯一且正确的
struct Set: Identifiable {
    let id = UUID()
    var purpose: String
    var items: [ExerciseItem]
}

// 在ForEach中使用（显式指定id更稳妥）
ForEach(sets, id: \.id) { set in
    NavigationLink(destination: ExerciseVideoView(items: set.items )) {
        // Image代码
    }
}

如果Identifiable实现有问题，包裹在NavigationLink里时可能会放大渲染异常（虽然移除导航组件时能显示，但导航容器对视图标识的要求更严格）。

4. 适配iOS版本的导航组件 #

如果你使用的是iOS 16及以上版本，NavigationView已经被弃用，建议换成NavigationStack，兼容性更好：

var body: some View {
    NavigationStack { // 替换NavigationView
        VStack {
            ForEach(sets) { set in
                NavigationLink(destination: ExerciseVideoView(items: set.items )) {
                    Image("group-\(set.purpose)")
                        .resizable()
                        .aspectRatio(contentMode: .fit)
                        .frame(height: 300)
                }
            }
        }
    }
}

5. 调试图片加载状态 #

可以给Image添加调试代码，确认实际加载的图片名称和加载状态：

Image("group-\(set.purpose)")
    .resizable()
    .frame(height: 300)
    .onAppear {
        print("Attempting to load image: group-\(set.purpose)")
    }
    .onFailure(perform: { error in
        print("Image load failed: \(error.localizedDescription)")
    })

通过控制台打印的信息，就能快速定位是图片名称错误还是加载失败。

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