无法为自定义TableViewCell中的UIImageView设置图片

场景概述 #

iOS应用中使用带自定义UITableViewCell的UITableView，Cell包含UIImageView。点击Cell弹出ActionSheet，选择从相册导入图片后，控制台打印图片设置成功，但Cell内图片并未显示。同时添加新Cell时会出现约束警告："Changing the translatesAutoresizingMaskIntoConstraints property of a UICollectionViewCell that is managed by a UICollectionView is not supported, and will result in incorrect self-sizing."，暂不确定该警告与当前问题关联。

核心问题原因 #

直接通过tableView(_:cellForRowAt:)获取Cell并修改UI的方式不可靠：

1. 若目标Cell当前不在屏幕可见范围内，该方法会创建新Cell实例而非复用屏幕上的Cell，导致设置的图片无法显示在用户看到的Cell上
2. UITableView的Cell复用机制会在Cell滚动或刷新时，用数据源内容覆盖Cell的UI，直接修改Cell的内容会丢失

解决方案：更新数据源+刷新Cell #

1. 给数据模型添加图片属性 #

假设你的数据模型是GearComponent，添加用于存储图片的属性（若需要持久化可改用Data类型）：

class GearComponent {
    // 原有属性：name、weight、quantity等
    var image: UIImage?
    // ...其他属性初始化及定义
}

2. 修改图片选择完成后的代理方法 #

不再直接操作Cell，而是更新对应数据源的图片属性，再刷新目标Cell：

func imagePickerController(_ picker: UIImagePickerController, didFinishPickingMediaWithInfo info: [UIImagePickerController.InfoKey : Any]) {
    guard let image = info[.editedImage] as? UIImage else { return }
    
    dismiss(animated: true)
    
    // 更新数据源中对应项的图片
    itemArray[cellChosen.row].image = image
    // 刷新目标Cell，确保UI从数据源同步
    gearTableView.reloadRows(at: [cellChosen], with: .automatic)
    
    print("item image set for the item at position: \(cellChosen.row)")
}

3. 在Cell配置逻辑中绑定图片 #

在tableView(_:cellForRowAt:)方法里，从数据源获取图片并设置给Cell的UIImageView：

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "GearComponentTableViewCell", for: indexPath) as! GearComponentTableViewCell
    let currentItem = itemArray[indexPath.row]
    
    // 配置其他UI元素
    cell.itemName.text = currentItem.name
    cell.itemWeight1.text = "\(currentItem.weight)"
    cell.itemQuanity.text = "\(currentItem.quantity)"
    // ...其他UI配置
    
    // 绑定图片，可添加占位图优化体验
    cell.itemImage.image = currentItem.image ?? UIImage(named: "default_gear_icon")
    
    return cell
}

关于UICollectionView约束警告 #

该警告来自UICollectionView相关代码，与当前UITableViewCell图片显示问题无关，可后续排查UICollectionViewCell的约束配置或代码修改逻辑。

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