iOS按钮仅点击时显示图片：如何让图片持久显示？

这个问题我之前也碰到过，大概率是图片渲染模式配合状态设置或者bundle加载的问题，咱们一步步来解决：

1. 先排除Bundle加载问题 #

你用了getBundleForCommon()来获取资源包，首先得确认这个bundle里真的包含名为"X"的图片，而且图片的target membership已经勾选。可以先临时换成main bundle测试：

button.setImage(UIImage(named: "X")?.withRenderingMode(.alwaysTemplate), for: .normal)

如果换成main bundle后图片能正常显示，那就是你自定义的bundle加载逻辑有问题，得检查getBundleForCommon()的实现是否正确获取到了包含图片的bundle。

2. 检查TintColor设置（重点！） #

因为你用了.alwaysTemplate渲染模式，图片的显示颜色完全由按钮的tintColor决定。如果normal状态下的tintColor和按钮背景色一致，图片就会看起来“消失”，而点击按钮进入highlighted状态时，系统可能自动调整了tintColor，所以图片才会临时显示出来。

解决方法很简单，显式设置按钮的tintColor为可见的颜色：

button.tintColor = .systemBlue // 换成你需要的颜色，比如黑色、主题色等

3. 为所有相关状态统一设置图片 #

按钮有多种状态（normal、highlighted、selected等），如果只给.normal状态设置图片，切换到其他状态时图片会消失。建议把相同的图片设置给所有需要显示的状态：

// 先复用同一个图片对象，避免重复加载
guard let templateImage = UIImage(named: "X", in: getBundleForCommon(), compatibleWith: nil)?.withRenderingMode(.alwaysTemplate) else {
    print("图片加载失败！")
    return
}

button.setImage(templateImage, for: .normal)
button.setImage(templateImage, for: .highlighted)
button.setImage(templateImage, for: .selected)

4. 额外排查：EdgeInsets设置 #

如果上面的方法都没用，检查一下按钮的imageEdgeInsets和contentEdgeInsets，看看是不是图片被挤出了按钮的可视区域。可以临时重置这些Insets测试：

button.imageEdgeInsets = .zero
button.contentEdgeInsets = .zero

按照这个流程排查，应该就能让图片持久显示啦！

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