iOS14最低部署下SwiftUI适配iOS16修改List背景色方案

针对你的问题——iOS14+的SwiftUI应用在iOS16模拟器中List背景显示异常，且scrollContentBackground(.hidden)仅支持iOS16导致编译报错，可通过版本条件判断实现全版本兼容：

完整兼容代码 #

struct ContentView: View {
    var body: some View {
        // 保持iOS14/15下的透明设置
        UITableView.appearance().backgroundColor = .clear
        UICollectionView.appearance().backgroundColor = .clear
        
        ZStack {
            Color(.blue)
                .edgesIgnoringSafeArea(.all)

            VStack {
                Text("Hello World")
                List {
                    Text("Item1")
                    Text("Item2")
                }
                .listStyle(InsetGroupedListStyle())
                // 仅在iOS16及以上应用该修饰符
                .modifier(ScrollBackgroundModifier())
            }
        }
    }
}

// 自定义版本适配修饰符
struct ScrollBackgroundModifier: ViewModifier {
    func body(content: Content) -> some View {
        if #available(iOS 16.0, *) {
            content.scrollContentBackground(.hidden)
        } else {
            content
        }
    }
}

方案说明 #

1. 原有逻辑保留：UITableView.appearance().backgroundColor = .clear在iOS14-15中依然有效，能让List底层的原生视图透明，从而显示ZStack的背景色。
2. 版本隔离新特性：通过自定义ViewModifier，仅在iOS16及以上版本添加scrollContentBackground(.hidden)，解决iOS16模拟器的背景覆盖问题，同时避免低版本编译报错。
3. 复用性强：自定义修饰符可以在项目中所有需要适配的List上复用，不用重复写版本判断。

也可以直接用内联的版本判断（适合简单场景）：

List {
    Text("Item1")
    Text("Item2")
}
.listStyle(InsetGroupedListStyle())
#if os(iOS 16.0)
.scrollContentBackground(.hidden)
#endif

这个方案同时覆盖iOS14/15/16的真机和模拟器，保证自定义背景色正常显示。

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