如何在TableView结合SearchBar时保持单元格复选标记状态

这个问题我之前也碰到过，其实核心就是要让选中状态和原始数据绑定，而不是依赖当前显示的过滤后的数组或者行索引，这样不管是搜索还是非搜索状态，复选标记都能准确对应到正确的单元格。我给你一步步拆解实现方案：

核心思路 #

不要用单元格显示的文本（或者当前行的索引）来记录选中状态——因为搜索过滤后，行索引会变化，文本也可能存在重复。正确的做法是：

1. 用一个数组专门存储原始数据中被选中的项（或其唯一标识）
2. 在点击单元格时，找到当前行对应的原始数据项，更新选中数组
3. 在cellForRowAt方法中，根据当前行对应的原始数据项是否在选中数组里，设置复选标记

方案一：针对字符串数组（无重复文本场景） #

如果你的数据源是纯字符串数组，且没有重复内容，可以直接存选中的字符串：

// 定义全局/类级变量
var originalData = ["Apple", "Banana", "Cherry", "Date", "Elderberry"]
var filteredData: [String] = []
var isSearching = false
var checkedItems: [String] = [] // 存储选中的字符串

// MARK: - UISearchBar 代理方法
func searchBar(_ searchBar: UISearchBar, textDidChange searchText: String) {
    isSearching = !searchText.isEmpty
    // 过滤原始数据生成搜索结果
    filteredData = originalData.filter { $0.lowercased().contains(searchText.lowercased()) }
    tableView.reloadData()
}

func searchBarCancelButtonClicked(_ searchBar: UISearchBar) {
    isSearching = false
    searchBar.text = ""
    tableView.reloadData() // 取消搜索后刷新表格，恢复所有行的选中状态
}

// MARK: - UITableView 数据源方法
func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
    return isSearching ? filteredData.count : originalData.count
}

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "YourCellID", for: indexPath)
    // 获取当前行对应的原始数据项（不管是否在搜索状态）
    let currentItem = isSearching ? filteredData[indexPath.row] : originalData[indexPath.row]
    cell.textLabel?.text = currentItem
    // 根据选中数组设置复选标记
    cell.accessoryType = checkedItems.contains(currentItem) ? .checkmark : .none
    return cell
}

// MARK: - UITableView 代理方法（处理单元格点击）
func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
    tableView.deselectRow(at: indexPath, animated: true) // 取消选中高亮
    let currentItem = isSearching ? filteredData[indexPath.row] : originalData[indexPath.row]
    
    // 更新选中数组
    if let index = checkedItems.firstIndex(of: currentItem) {
        checkedItems.remove(at: index) // 已选中则取消
    } else {
        checkedItems.append(currentItem) // 未选中则添加
    }
    
    // 刷新当前行的复选标记
    tableView.reloadRows(at: [indexPath], with: .automatic)
}

方案二：自定义模型（推荐，支持重复内容场景） #

如果你的数据存在重复文本，或者后续可能扩展数据结构，建议用自定义模型+唯一ID来记录选中状态，避免混淆：

// 定义自定义数据模型，添加唯一ID
struct Fruit {
    let id: UUID // 唯一标识，不会重复
    let name: String
    
    init(name: String) {
        self.id = UUID()
        self.name = name
    }
}

// 定义全局/类级变量
var originalData: [Fruit] = [
    Fruit(name: "Apple"),
    Fruit(name: "Banana"),
    Fruit(name: "Apple"), // 允许重复文本
    Fruit(name: "Date")
]
var filteredData: [Fruit] = []
var isSearching = false
var checkedIDs: [UUID] = [] // 存储选中项的唯一ID

// MARK: - UISearchBar 代理方法
func searchBar(_ searchBar: UISearchBar, textDidChange searchText: String) {
    isSearching = !searchText.isEmpty
    filteredData = originalData.filter { $0.name.lowercased().contains(searchText.lowercased()) }
    tableView.reloadData()
}

// MARK: - UITableView 数据源方法
func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "YourCellID", for: indexPath)
    let currentFruit = isSearching ? filteredData[indexPath.row] : originalData[indexPath.row]
    cell.textLabel?.text = currentFruit.name
    // 根据唯一ID判断是否选中
    cell.accessoryType = checkedIDs.contains(currentFruit.id) ? .checkmark : .none
    return cell
}

// MARK: - UITableView 代理方法（处理单元格点击）
func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
    tableView.deselectRow(at: indexPath, animated: true)
    let currentFruit = isSearching ? filteredData[indexPath.row] : originalData[indexPath.row]
    
    if let index = checkedIDs.firstIndex(of: currentFruit.id) {
        checkedIDs.remove(at: index)
    } else {
        checkedIDs.append(currentFruit.id)
    }
    
    tableView.reloadRows(at: [indexPath], with: .automatic)
}

关键注意点 #

1. 切换搜索状态时（比如取消搜索），一定要调用tableView.reloadData()，让表格重新根据选中数组渲染所有行的复选标记
2. 不要用行索引记录选中状态——搜索过滤后，同一索引对应的原始数据项会变化，导致复选标记错位
3. 如果数据可能重复，一定要用唯一ID（比如UUID）来绑定选中状态，避免误判

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