iOS开发中UIButton调用setImage(nil)无法清除已设置图片问题

你现有代码中的tag匹配遍历逻辑本身没有问题，无法清空图片是UIButton的图片存储/配置机制导致的，可参考以下方案排查：

• 仅清除了单一状态的图片
  UIButton的图片是分状态独立存储的，你当前仅清空了.normal状态的图片，如果按钮处于.highlighted、.selected等其他状态，或是其他状态也设置过相同图片，就会出现图标残留。需要把所有用到的状态都执行清空操作：

cell.setImage(nil, for: .normal)
cell.setImage(nil, for: .highlighted)
cell.setImage(nil, for: .selected)

• 混淆了图片和背景图片接口
  如果你之前是通过setBackgroundImage(_:for:)方法设置的图标，调用setImage(_:for:)无法清除对应的内容，需要对应调用背景图片的清空方法：

cell.setBackgroundImage(nil, for: .normal)
// 同理清空其他状态的背景图
cell.setBackgroundImage(nil, for: .highlighted)
cell.setBackgroundImage(nil, for: .selected)

• 使用了iOS15+的UIButton.Configuration配置
  iOS15之后引入的按钮配置体系优先级高于传统的setImage方法，如果你的按钮使用了configuration属性设置样式，直接调用setImage不会生效，需要修改配置本身的image属性：

var config = cell.configuration
config?.image = nil
cell.configuration = config

• UI更新未正常触发
  虽然IBAction默认在主线程执行，你也可以主动将UI更新逻辑放到主队列异步执行，确保状态刷新优先级：

DispatchQueue.main.async {
    cell.setImage(nil, for: .normal)
}

你最终选择的控制isHidden属性的方案也是非常成熟的替代方案，不需要修改按钮本身的图片配置，通过cell.imageView?.isHidden = true即可快速隐藏图标，逻辑更简单也不容易出现多状态冲突。

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