Swift中UITableViewController插入行不替换原有行的实现方法

你之前的写法错误核心是没有调整TableView的总渲染行数，也没有做「展示行索引」和「原始Firebase数据索引」的映射，只是强行把指定位置的cell内容替换成自定义文本，本质还是在渲染原始数据的行，自然会覆盖原有内容。另外你写的indexPath.row % 3 == 0也踩了UITableView行号从0开始计数的坑，会命中第1、4、7行（对应row=0、3、6）的原始数据位置，和你想要插入的位置完全不符。

核心思路是把「展示层的行」和「原始数据的行」分开处理，有两种常用实现方式，按需选择即可。

方案1：索引映射（适合数据量较大的场景） #

不需要修改原始Firebase数据数组，通过计算规则实时判断当前行类型、映射原始数据索引，只需要修改核心数据源方法即可：

1. 先修正numberOfRowsInSection的总行数计算，把要插入的自定义行数量算进去
   按照你要的「每2条原始数据后插入1条自定义文本」的规则，总行数计算代码如下：

   override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
       let originalCount = firebaseDataList.count // 从Firebase拉取的原始数据数组
       let insertCustomCount = (originalCount - 1) / 2 // 整数除法自动取整，对应要插入的自定义行数量
       return originalCount + insertCustomCount
   }
   

2. 在cellForRowAt中先判断行类型，再分别处理
   注意行号从0开始计数，你需要的自定义行位置是row=2、row=5（对应肉眼看到的第3、第6行），判断逻辑和索引映射代码如下：

   override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
       // 判断当前行是否为自定义文本行
       if (indexPath.row + 1) % 3 == 0 {
           let cell = tableView.dequeueReusableCell(withIdentifier: "CustomCell", for: indexPath)
           cell.textLabel?.text = "应用内自定义文本"
           return cell
       } else {
           // 计算当前展示行对应的原始数据数组下标
           let originalIndex = indexPath.row - (indexPath.row / 3)
           let cell = tableView.dequeueReusableCell(withIdentifier: "DataCell", for: indexPath)
           let data = firebaseDataList[originalIndex]
           cell.textLabel?.text = data.content // 赋值原始数据内容，比如abc/def/ghi
           return cell
       }
   }
   

3. 所有涉及行索引的交互逻辑（比如didSelectRowAt点击事件、行高计算、编辑操作），都要先做上述索引判断/转换，不要直接用indexPath.row取原始数组数据，避免数组越界或者取错内容。

方案2：构建混合展示数组（适合绝大多数普通场景，维护性更高） #

如果你觉得计算索引容易出错，可以在拿到Firebase原始数据后，直接生成一个专门用于TableView展示的混合数组，把原始数据和自定义文本都作为数组元素，后续所有数据源方法直接读这个数组即可，完全不需要做索引计算。
示例代码：

// 先定义行类型枚举
enum ListRowItem {
    case originalData(FirebaseDataModel) // 原始Firebase数据
    case customText(String) // 自定义文本行
}

// 拿到Firebase数据后，生成展示用的混合数组
var displayList: [ListRowItem] = []
for (index, data) in firebaseDataList.enumerated() {
    displayList.append(.originalData(data))
    // 每2条原始数据后插入1条自定义文本，最后一条数据后面不插
    if (index + 1) % 2 == 0, index != firebaseDataList.count - 1 {
        displayList.append(.customText("应用内自定义文本"))
    }
}

之后数据源方法直接用displayList处理即可，逻辑非常简单：

override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
    return displayList.count
}

override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let item = displayList[indexPath.row]
    switch item {
    case .originalData(let data):
        let cell = tableView.dequeueReusableCell(withIdentifier: "DataCell", for: indexPath)
        cell.textLabel?.text = data.content
        return cell
    case .customText(let text):
        let cell = tableView.dequeueReusableCell(withIdentifier: "CustomCell", for: indexPath)
        cell.textLabel?.text = text
        return cell
    }
}

注意：如果后续Firebase数据有更新（比如拉取到新数据、删除了原有数据），只需要重新生成一次displayList，调用tableView.reloadData()即可正常刷新，不需要调整其他逻辑。

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