Swift新手求助：如何在TableView中实现联系人按字母分组并设置分区标题

作为Swift新手，处理联系人分组排序确实需要捋清楚几个关键步骤，我结合你提供的代码结构，一步步拆解具体实现方法：

首先，我们需要把现有的addressArray转换成可用于TableView分区的分组数据结构，新增两个属性来存储处理后的数据：

class AddressViewController: UITableViewController {
    var addressArray = [AddressModel]()
    // 存储分组后的联系人：键是首字母，值是对应分组的联系人数组
    private var groupedContacts = [String: [AddressContact]]()
    // 存储排序后的首字母列表，用来确定分区的展示顺序
    private var sortedSectionTitles = [String]()
    
    override func viewDidLoad() {
        super.viewDidLoad()
        // 视图加载完成后，调用分组处理方法
        processContactsForGrouping()
    }
}

核心分组排序逻辑实现 #

接下来实现processContactsForGrouping方法，完成从原始数据到分组数据的转换：

private func processContactsForGrouping() {
    // 1. 先把嵌套的AddressContact提取成一维数组，方便后续处理
    let allContacts = addressArray.flatMap { $0.nameAndPhone }
    
    // 2. 遍历所有联系人，按首字母分组
    for contact in allContacts {
        // 组合姓氏+名字，得到完整姓名
        let fullName = "\(contact.contact.familyName)\(contact.contact.givenName)"
        
        // 生成分区标题：处理空姓名、非英文字母的情况
        let sectionTitle: String
        if let firstChar = fullName.first {
            let upperChar = String(firstChar).uppercased()
            // 非英文字母（比如中文、特殊符号）统一放到"#"分组
            sectionTitle = upperChar.rangeOfCharacter(from: .letters) != nil ? upperChar : "#"
        } else {
            // 空姓名的联系人也放到"#"分组
            sectionTitle = "#"
        }
        
        // 将联系人添加到对应分组中
        if var group = groupedContacts[sectionTitle] {
            group.append(contact)
            groupedContacts[sectionTitle] = group
        } else {
            groupedContacts[sectionTitle] = [contact]
        }
    }
    
    // 3. 对分区首字母排序：A-Z顺序，"#"分组排在最后
    sortedSectionTitles = groupedContacts.keys.sorted {
        if $0 == "#" {
            return false
        } else if $1 == "#" {
            return true
        } else {
            return $0 < $1
        }
    }
    
    // 4. 可选：对每个分组内的联系人按姓名排序
    for title in sortedSectionTitles {
        groupedContacts[title] = groupedContacts[title]?.sorted {
            let nameA = "\($0.contact.familyName)\($0.contact.givenName)"
            let nameB = "\($1.contact.familyName)\($1.contact.givenName)"
            return nameA < nameB
        }
    }
    
    // 处理完成后刷新表格
    tableView.reloadData()
}

配置TableView数据源方法 #

最后修改TableView的数据源方法，用分组后的数据实现分区标题和单元格展示：

// 返回分区数量
override func numberOfSections(in tableView: UITableView) -> Int {
    return sortedSectionTitles.count
}

// 设置分区标题（就是你需要的titleForHeaderInSection方法）
override func tableView(_ tableView: UITableView, titleForHeaderInSection section: Int) -> String? {
    return sortedSectionTitles[section]
}

// 返回每个分区的行数
override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
    let sectionTitle = sortedSectionTitles[section]
    return groupedContacts[sectionTitle]?.count ?? 0
}

// 配置单元格内容
override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    // 替换成你自己的cell标识符
    let cell = tableView.dequeueReusableCell(withIdentifier: "ContactCell", for: indexPath)
    let sectionTitle = sortedSectionTitles[indexPath.section]
    
    guard let contact = groupedContacts[sectionTitle]?[indexPath.row] else {
        return cell
    }
    
    // 配置姓名
    let fullName = "\(contact.contact.familyName)\(contact.contact.givenName)"
    cell.textLabel?.text = fullName
    
    // 配置手机号：从CNPhoneNumber中提取字符串
    if let phoneNum = contact.contact.phoneNumbers.first?.value.stringValue {
        cell.detailTextLabel?.text = phoneNum
    } else {
        cell.detailTextLabel?.text = "无手机号"
    }
    
    return cell
}

关键细节说明 #

• 非英文字母处理：中文、特殊符号等非英文字母的联系人统一放到#分组，这是通讯录类App的常规做法；如果需要中文按拼音首字母分组，你可以额外引入拼音转换库（比如HanziPinyin）来优化。
• 动态数据更新：如果你的addressArray是动态加载的（比如网络请求、本地数据库更新），记得在数据更新后调用processContactsForGrouping()方法重新分组并刷新表格。
• 空数据防护：代码中加入了空值判断，避免因空姓名、空联系人数组导致的崩溃。

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