Swift中双UITableView分组标题灰色单行，修改后标题消失如何解决？

核心问题分析 #

• 默认titleForHeaderInSection返回的标题样式由系统统一控制，无法修改颜色和行数，必须通过viewForHeaderInSection自定义头部视图。
• 自定义视图消失的常见原因：
  1. 未实现heightForHeaderInSection设置头部高度，系统默认高度为0导致视图被隐藏
  2. 自定义UILabel未配置正确的行数、颜色或约束
  3. 未正确返回自定义视图，或视图本身尺寸为0

完整解决方案代码 #

1. 必须同时实现两个代理方法 #

// MARK: - UITableViewDelegate
func tableView(_ tableView: UITableView, viewForHeaderInSection section: Int) -> UIView? {
    // 创建头部容器视图
    let headerView = UIView()
    headerView.backgroundColor = .white // 按需设置背景色

    // 创建标题Label
    let titleLabel = UILabel()
    titleLabel.translatesAutoresizingMaskIntoConstraints = false
    titleLabel.text = "你的分组标题，支持两行显示的长文本内容"
    titleLabel.textColor = .black
    titleLabel.numberOfLines = 2
    titleLabel.font = UIFont.systemFont(ofSize: 16, weight: .medium) // 自定义字体

    headerView.addSubview(titleLabel)

    // 添加约束，确保Label有边距
    NSLayoutConstraint.activate([
        titleLabel.leadingAnchor.constraint(equalTo: headerView.leadingAnchor, constant: 16),
        titleLabel.trailingAnchor.constraint(equalTo: headerView.trailingAnchor, constant: -16),
        titleLabel.topAnchor.constraint(equalTo: headerView.topAnchor, constant: 8),
        titleLabel.bottomAnchor.constraint(equalTo: headerView.bottomAnchor, constant: -8)
    ])

    return headerView
}

func tableView(_ tableView: UITableView, heightForHeaderInSection section: Int) -> CGFloat {
    // 自适应高度或固定高度（比如60）
    return UITableView.automaticDimension
}

2. 多TableView区分处理 #

如果两个并排TableView的标题内容不同，需在代理方法中区分：

func tableView(_ tableView: UITableView, viewForHeaderInSection section: Int) -> UIView? {
    let headerView = UIView()
    let titleLabel = UILabel()
    titleLabel.translatesAutoresizingMaskIntoConstraints = false
    titleLabel.numberOfLines = 2
    titleLabel.textColor = .black

    // 区分左右TableView的标题
    if tableView == leftTableView {
        titleLabel.text = "左侧分组\(section)标题"
    } else if tableView == rightTableView {
        titleLabel.text = "右侧分组\(section)标题"
    }

    headerView.addSubview(titleLabel)
    NSLayoutConstraint.activate([
        titleLabel.leadingAnchor.constraint(equalTo: headerView.leadingAnchor, constant: 16),
        titleLabel.trailingAnchor.constraint(equalTo: headerView.trailingAnchor, constant: -16),
        titleLabel.topAnchor.constraint(equalTo: headerView.topAnchor, constant: 8),
        titleLabel.bottomAnchor.constraint(equalTo: headerView.bottomAnchor, constant: -8)
    ])

    return headerView
}

排查要点（若视图仍消失） #

• 确认heightForHeaderInSection返回值大于0
• 调试自定义视图的frame，检查尺寸是否正确
• 检查Label的text是否为空，或颜色与背景色一致导致不可见

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