设置UIButton的isSelected为true时对应状态图片未切换问题

• 检查是否存在其他代码覆盖了按钮图片配置
  如果你在按钮状态切换的前后手动调用了setImage(_:for:)给.normal状态重复赋值，或者通过image属性直接设置了固定图片，会覆盖你之前配置的多状态图片规则。确保仅在初始化按钮时配置不同状态的图片，后续仅通过修改isSelected属性切换状态。
• 检查是否误设置了按钮的背景图遮盖了前景图
  如果你同时给按钮设置了backgroundImage，背景图会位于前景图片下方，若背景图不透明可能会遮盖你配置的状态图片。可以将状态图片配置到backgroundImage，或者移除不必要的背景图配置：

  // 如果使用背景图实现可以替换为如下配置
  upArrow.setBackgroundImage(UIImage(named: "likeButtonFill"), for: .selected)
  upArrow.setBackgroundImage(UIImage(named: "likeButton"), for: .normal)
  

• 检查状态修改是否在主线程执行
  UI属性修改必须在主线程执行，否则会出现不生效、延迟生效的问题，修改状态的代码需要包裹在主线程调度逻辑中：

  DispatchQueue.main.async {
      self.upArrow.isSelected = true
  }
  

• 检查UITableViewCell复用场景下的状态同步
  如果是在Cell复用时修改按钮状态，必须确保每次配置Cell时都同步更新按钮的isSelected属性，不能仅依赖点击事件修改，否则复用时会出现状态错乱：

  func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
      let cell = tableView.dequeueReusableCell(withIdentifier: "CellID", for: indexPath) as! CustomCell
      // 每次配置Cell都同步按钮选中状态
      cell.upArrow.isSelected = dataArray[indexPath.row].isLiked
      return cell
  }
  

• 检查图片资源命名是否正确
  iOS中资源文件名大小写敏感，确认Assets.xcassets中对应的图片名和代码中填写的完全一致，没有拼写错误、大小写偏差。
• 检查按钮其他属性是否冲突
  若你设置了adjustsImageWhenHighlighted = true、adjustsImageWhenDisabled = true，或者给按钮设置了tintColor且图片渲染模式为.alwaysTemplate，也可能导致图片展示异常，可尝试临时关闭这些属性验证问题：

  upArrow.adjustsImageWhenHighlighted = false
  upArrow.imageView?.contentMode = .scaleAspectFit
  // 如果不需要模板渲染，指定图片渲染模式为原图
  upArrow.setImage(UIImage(named: "likeButtonFill")?.withRenderingMode(.alwaysOriginal), for: .selected)
  upArrow.setImage(UIImage(named: "likeButton")?.withRenderingMode(.alwaysOriginal), for: .normal)
  

• 检查自定义UIButton子类的重写逻辑
  如果你使用了自定义的UIButton子类，并且重写了isSelected属性的setter方法，必须确保调用了super.isSelected = newValue，否则父类的状态切换逻辑不会触发，图片也不会更新：

  override var isSelected: Bool {
      didSet {
          // 你的自定义逻辑，不需要手动修改image，父类会自动处理状态切换
      }
  }
  
  // 如果重写了setter方法必须调用super
  override var isSelected: Bool {
      set {
          super.isSelected = newValue
          // 你的自定义逻辑
      }
      get {
          return super.isSelected
      }
  }
  

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