iOS：取消Debug executable/冷启动时UIButton图片消失问题

• 在Storyboard中创建的UIButton，配置的图片资源存放在Assets.xcassets内
• 模拟器运行、真机首次安装启动时按钮图片可正常显示
• 真机退出应用后重新冷启动，按钮图片消失，但按钮点击交互完全正常
• Xcode中Edit Scheme取消勾选Debug executable时，可稳定复现上述图片消失问题
• 视图层级调试显示按钮处于最顶层，但视觉上不可见；调用infoButton.isHidden = false、在viewDidLoad()中执行view.bringSubviewToFront(_: infoButton)均无法解决
• 尝试纯代码重新设置按钮图片仍不显示，但执行infoButton.backgroundColor = UIColor.blue设置背景色时，按钮位置可正常显示蓝色色块，仅图片内容无法渲染

这个问题是Release环境下UIAppearance配置生效时机变化+图片渲染模式共同导致的：

• 取消Debug executable后Xcode会以Release模式运行应用，此时系统的资源加载、UIAppearance生效逻辑和Debug模式有差异：Debug模式下Xcode的调试注入会延迟UIAppearance的生效时机，Storyboard加载的按钮配置不会被全局配置覆盖；Release模式下UIAppearance优先级更高，会提前覆盖控件属性。
• 大概率是项目中存在全局调用UIButton.appearance().tintColor = .clear的逻辑（可能来自业务代码、第三方SDK、UI扩展分类中的全局设置），同时Assets里的按钮图片Render As属性为Default/Template模式，图片会跟随tintColor渲染为透明，导致视觉上看不到图片。
• 真机首次启动时系统会做应用资源预解压，Storyboard加载优先级高于UIAppearance配置，tintColor不会被覆盖因此显示正常；第二次启动走资源缓存路径，UIAppearance提前生效就会触发图片透明问题。
• 按钮的背景色不受tintColor和图片渲染模式影响，因此设置背景色可以正常显示，按钮的交互、层级属性也完全正常。

按优先级依次排查处理：

• 全局搜索所有调用UIButton.appearance()的代码，删除将tintColor设置为UIColor.clear的逻辑，如果需要全局配置按钮样式，针对特定自定义按钮类单独设置外观，不要全局污染UIButton的默认属性。
• 打开Assets.xcassets中对应按钮图片的属性面板，将Render As选项从Default修改为Always Original，强制图片以原始像素渲染，不受tintColor影响。也可以加代码兜底：

  // 确保图片以原始模式渲染
  let btnImage = UIImage(named: "info_button_icon")?.withRenderingMode(.alwaysOriginal)
  infoButton.setImage(btnImage, for: .normal)
  

• 关闭按钮的状态自动调整属性，排除按钮状态异常导致的图片透明问题：

  infoButton.adjustsImageWhenHighlighted = false
  infoButton.adjustsImageWhenDisabled = false
  

• 如果仍有问题，在viewDidAppear中增加兜底校验，手动重置图片视图的透明度：

  override func viewDidAppear(_ animated: Bool) {
      super.viewDidAppear(animated)
      infoButton.imageView?.alpha = 1
      infoButton.tintColor = .black // 替换为实际需要的按钮图标颜色
  }
  

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