iOS15以下如何设置UITableView第二个分区头部内边距？

核心错误原因 #

你代码里犯了一个关键错误：tableView.tableHeaderView是整个表格的全局顶部表头，和单个分区（section）的头部视图完全不是一回事。在第二个分区的逻辑里赋值tableView.tableHeaderView = view，只会把全局表头替换成第二个分区的头部内容，根本不会作用于第二个分区的头部，这就是padding无效的原因。另外，不存在tableView.tableHeaderView[2]或.second这类写法——tableHeaderView本身是单个视图，和分区头部没有关联。

正确实现方式 #

每个分区的头部视图是通过viewForHeaderInSection直接返回的，不需要修改tableView的tableHeaderView属性。要给分区头部添加内边距，推荐用容器视图嵌套内容的方式（比直接调整frame更稳妥，避免布局混乱），同时提取重复逻辑减少冗余。

修改后的代码 #

func tableView(_ tableView: UITableView, viewForHeaderInSection section: Int) -> UIView? {
    guard tableView.tag == 2 else {
        if #available(iOS 15.0, *) {
            tableView.sectionHeaderTopPadding = 0.0
        }
        return nil
    }
    
    guard self.tableView(tableView, numberOfRowsInSection: section) > 0 else {
        return nil
    }
    
    // 根据分区配置内容
    let (imageName, title) = section == 0 ? ("Logo_face", "店舗") : ("pinIconForSearch", "検索候補")
    
    // 容器视图，用来承载内边距
    let containerView = UIView()
    let padding: CGFloat = 20
    
    // 内容视图（原来的头部内容）
    let contentView = UIView()
    containerView.addSubview(contentView)
    
    // 添加图片和标签
    let imageView = UIImageView(image: UIImage(named: imageName))
    imageView.frame = CGRect(x: 10, y: 0, width: 25, height: 25)
    contentView.addSubview(imageView)
    
    let label = UILabel()
    label.text = title
    label.frame = CGRect(x: 40, y: 0, width: 200, height: 25)
    contentView.addSubview(label)
    
    // 处理iOS版本适配
    if #unavailable(iOS 15.0) {
        // iOS15以下：容器视图包含内边距，内容视图偏移padding
        containerView.frame = CGRect(x: 0, y: 0, width: tableView.bounds.width, height: 25 + 2 * padding)
        contentView.frame = CGRect(x: padding, y: padding, width: containerView.bounds.width - 2 * padding, height: 25)
    } else {
        // iOS15及以上：用系统属性控制顶部间距，内容视图填充满容器
        containerView.frame = CGRect(x: 0, y: 0, width: tableView.bounds.width, height: 25)
        contentView.frame = containerView.bounds
        tableView.sectionHeaderTopPadding = 0.0
    }
    
    return containerView
}

关键优化点 #

1. 移除错误的全局表头赋值：每个分区的头部视图直接返回即可，不需要修改tableView.tableHeaderView。
2. 容器视图实现内边距：用外层容器承载padding，内层视图放实际内容，避免直接调整frame导致的布局错位。
3. 合并重复逻辑：将两个分区的共同代码提取，通过条件判断区分图片和文字，减少冗余。
4. 版本适配更清晰：iOS15及以上用系统自带的sectionHeaderTopPadding控制间距，iOS15以下通过容器视图的padding实现需求。

额外说明 #

如果需要获取某个已渲染的分区头部视图，可以调用tableView.headerView(forSection: sectionIndex)方法——注意：只有当目标分区已经显示在屏幕上时，这个方法才会返回非nil值。

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