如何为UITableView的section header（viewForHeaderInSection）添加阴影效果？

我太懂这种挫败感了——普通View上加阴影顺风顺水，一放到UITableView的section header里就没效果，核心原因是UITableView会对header的布局和图层裁剪做特殊处理，下面几个亲测有效的方案，你可以按需选：

方案1：给Header套个「阴影容器View」（最稳妥） #

这是我平时用得最多的方法，原理是把阴影加在一个外层容器上，实际的header内容放在容器内部，避开tableView的裁剪限制：

func tableView(_ tableView: UITableView, viewForHeaderInSection section: Int) -> UIView? {
    // 1. 创建外层容器，作为最终返回给tableView的header
    let containerView = UIView(frame: CGRect(x: 0, y: 0, width: tableView.bounds.width, height: 60))
    containerView.backgroundColor = .clear // 必须透明，不然会盖住阴影
    
    // 2. 给容器设置阴影参数
    containerView.layer.shadowColor = UIColor.darkGray.cgColor
    containerView.layer.shadowOffset = CGSize(width: 0, height: 3)
    containerView.layer.shadowOpacity = 0.25
    containerView.layer.shadowRadius = 5
    containerView.layer.masksToBounds = false // 绝对不能开，否则阴影会被裁剪
    
    // 3. 创建你的实际header内容View
    let contentView = UIView(frame: containerView.bounds)
    contentView.backgroundColor = .white
    contentView.layer.cornerRadius = 8 // 可选，想要圆角的话开这个
    contentView.layer.masksToBounds = true // 内容View裁剪到圆角，不影响外层阴影
    
    // 4. 把内容View加到容器里，再添加你的UI元素（比如标题）
    containerView.addSubview(contentView)
    let titleLabel = UILabel(frame: CGRect(x: 16, y: 0, width: contentView.bounds.width - 32, height: 60))
    titleLabel.text = "Section \(section + 1)"
    titleLabel.font = UIFont.systemFont(ofSize: 16, weight: .semibold)
    contentView.addSubview(titleLabel)
    
    return containerView
}

如果用AutoLayout的话，记得给containerView和contentView加约束，确保布局适配不同屏幕尺寸。

方案2：关闭TableView的裁剪（最简单，但有副作用） #

有时候tableView的clipsToBounds默认是true，会把header超出自身范围的阴影裁掉，直接关闭就行：

// 在viewDidLoad里设置
tableView.clipsToBounds = false

⚠️ 注意：这个方法会让tableView所有超出边界的内容都显示出来，比如cell滑出屏幕时也不会被裁剪，如果你能接受这个副作用，那用它最省事。

方案3：手动指定阴影路径（适合不想嵌套View的情况） #

如果不想多套一层View，可以手动给header的layer指定shadowPath，明确告诉系统阴影的范围，避免被tableView误裁剪：

func tableView(_ tableView: UITableView, viewForHeaderInSection section: Int) -> UIView? {
    let headerView = UIView(frame: CGRect(x: 0, y: 0, width: tableView.bounds.width, height: 60))
    headerView.backgroundColor = .white
    
    // 基础阴影设置
    headerView.layer.shadowColor = UIColor.black.cgColor
    headerView.layer.shadowOffset = CGSize(width: 0, height: 2)
    headerView.layer.shadowOpacity = 0.3
    headerView.layer.shadowRadius = 4
    headerView.layer.masksToBounds = false
    
    // 关键：手动扩大阴影路径的范围，比header本身大一圈
    let shadowRect = headerView.bounds.insetBy(dx: -10, dy: -10)
    headerView.layer.shadowPath = UIBezierPath(rect: shadowRect).cgPath
    
    // 添加你的UI元素...
    return headerView
}

如果是自定义HeaderView，记得在layoutSubviews里更新shadowPath，因为view的frame会在布局后才确定：

class CustomHeader: UIView {
    override func layoutSubviews() {
        super.layoutSubviews()
        let shadowRect = bounds.insetBy(dx: -10, dy: -10)
        layer.shadowPath = UIBezierPath(rect: shadowRect).cgPath
    }
}

这几个方案我都在项目里用过，基本能解决90%的section header阴影问题，你可以根据自己的布局需求选～

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