解决Objective-C中UICollectionView滚动时单元格堆叠问题

1. 修复单元格复用残留问题（最常见诱因） #

UICollectionView滚动时会复用单元格，若未重置旧内容，就会出现堆叠假象。在cellForItemAtIndexPath方法中，必须先清空单元格所有可复用子视图的内容，再填充新数据：

- (UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath {
    static NSString *cellID = @"KanohiCollectionCell";
    KanohiCollectionCell *cell = [collectionView dequeueReusableCellWithReuseIdentifier:cellID forIndexPath:indexPath];
    
    // 重置单元格内容，彻底清除复用残留
    cell.itemImageView.image = nil;
    cell.itemTitleLabel.text = @"";
    cell.itemCountLabel.text = @"";
    
    // 填充当前物品数据
    KanohiItem *targetItem = self.kanohiFound[indexPath.item];
    cell.itemImageView.image = [UIImage imageNamed:targetItem.imageAssetName];
    cell.itemTitleLabel.text = targetItem.displayName;
    cell.itemCountLabel.text = [NSString stringWithFormat:@"x%ld", (long)targetItem.quantity];
    
    return cell;
}

2. 校验布局尺寸与间距配置 #

若布局计算错误，单元格会因尺寸或间距设置不当出现重叠。检查并修正UICollectionViewLayout代理方法：

// 单元格尺寸计算
- (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout sizeForItemAtIndexPath:(NSIndexPath *)indexPath {
    // 示例：3列布局，自动适配屏幕宽度
    CGFloat totalPadding = 30; // 左右内边距+中间列间距总和
    CGFloat cellWidth = (collectionView.bounds.size.width - totalPadding) / 3;
    return CGSizeMake(cellWidth, cellWidth + 45); // 高度=宽度+标签区域高度
}

// 全局内边距
- (UIEdgeInsets)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout insetForSectionAtIndex:(NSInteger)section {
    return UIEdgeInsetsMake(12, 10, 12, 10);
}

// 行间距
- (CGFloat)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout minimumLineSpacingForSectionAtIndex:(NSInteger)section {
    return 12;
}

// 列间距
- (CGFloat)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout minimumInteritemSpacingForSectionAtIndex:(NSInteger)section {
    return 10;
}

3. 排查单元格内部约束问题 #

若单元格子视图的Auto Layout约束冲突或缺失，会导致内容错位堆叠。确保单元格内部约束完整且无冲突：

// 自定义单元格初始化方法示例
- (instancetype)initWithFrame:(CGRect)frame {
    self = [super initWithFrame:frame];
    if (self) {
        // 初始化图片视图
        self.itemImageView = [[UIImageView alloc] init];
        self.itemImageView.translatesAutoresizingMaskIntoConstraints = NO;
        self.itemImageView.contentMode = UIViewContentModeScaleAspectFit;
        [self.contentView addSubview:self.itemImageView];
        
        // 初始化标题标签
        self.itemTitleLabel = [[UILabel alloc] init];
        self.itemTitleLabel.translatesAutoresizingMaskIntoConstraints = NO;
        self.itemTitleLabel.textAlignment = NSTextAlignmentCenter;
        self.itemTitleLabel.font = [UIFont systemFontOfSize:12];
        [self.contentView addSubview:self.itemTitleLabel];
        
        // 添加约束
        [NSLayoutConstraint activateConstraints:@[
            self.itemImageView.topAnchor.constraintEqualToAnchor:self.contentView.topAnchor constant:8,
            self.itemImageView.leadingAnchor.constraintEqualToAnchor:self.contentView.leadingAnchor constant:8,
            self.itemImageView.trailingAnchor.constraintEqualToAnchor:self.contentView.trailingAnchor constant:-8,
            self.itemImageView.heightAnchor.constraintEqualToAnchor:self.itemImageView.widthAnchor,
            
            self.itemTitleLabel.topAnchor.constraintEqualToAnchor:self.itemImageView.bottomAnchor constant:8,
            self.itemTitleLabel.leadingAnchor.constraintEqualToAnchor:self.contentView.leadingAnchor,
            self.itemTitleLabel.trailingAnchor.constraintEqualToAnchor:self.contentView.trailingAnchor,
            self.itemTitleLabel.bottomAnchor.constraintEqualToAnchor:self.contentView.bottomAnchor constant:-8
        ]];
    }
    return self;
}

4. 确保数据源刷新逻辑正确 #

更新物品数据后，必须正确触发UICollectionView刷新，避免数据源与视图不同步：

// 添加新物品后局部刷新（推荐，性能优于全局reload）
[self.kanohiFound addObject:newCollectedItem];
NSIndexPath *newItemIndex = [NSIndexPath indexPathForItem:self.kanohiFound.count-1 inSection:0];
[self.collectionView insertItemsAtIndexPaths:@[newItemIndex]];

// 若需全局刷新，确保在主线程执行
dispatch_async(dispatch_get_main_queue(), ^{
    [self.collectionView reloadData];
});

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