SwiftUI如何取消列表（List）头部的半透明背景？

问题原因 #

使用.plain样式的List时，Section头部滚动到顶部后出现的半透明背景，来自系统默认的UITableViewHeaderFooterView容器，而非Section的header视图本身，所以直接设置Section背景无法生效。

解决步骤 #

1. 清空系统头部容器背景
   在视图的初始化方法中，通过UIKit外观配置移除系统默认的半透明背景：

init() {
    // 可选：移除Section头部默认顶部间距
    UITableView.appearance().sectionHeaderTopPadding = 0
    // 清空系统头部容器的背景
    UITableViewHeaderFooterView.appearance().backgroundView = UIView()
    UITableViewHeaderFooterView.appearance().backgroundColor = .clear
}

2. 自定义适配深浅色的Section头部
   创建自定义头部视图，使用系统动态颜色Color(.systemBackground)自动跟随配色方案切换：

struct CustomSectionHeader: View {
    let title: String
    
    var body: some View {
        Text(title)
            .font(.headline)
            .padding(.vertical, 8)
            .padding(.horizontal)
            .frame(maxWidth: .infinity, alignment: .leading)
            .background(Color(.systemBackground))
    }
}

3. 替换原有Section头部
   在List中使用自定义头部替代原生Text：

NavigationStack{
    List{
        Section{
            Text("列表项1")
            Text("列表项2")
            // 更多内容视图
        }header:{
            CustomSectionHeader(title: "Section Header")
        }
    }
    .listStyle(.plain)
}

效果说明 #

• Color(.systemBackground)会自动根据系统的浅色/深色模式，分别显示白色或深灰色背景，完全替代原有的半透明效果。
• 保留原生List的滚动粘性头部行为，同时实现背景的配色适配。

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