Swift项目中UIButton图片在真机及特定模拟器环境下消失的排查求助

1. 资源打包与关联检查 #

• 检查xcassets中目标图片的Target Membership：旧项目复制过来的资源很可能没关联当前主项目target，务必确认图片资源已勾选对应target。
• 核对Info.plist里的Asset Catalog Compiler Options：查看是否存在ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOLS这类影响资源加载的配置，新项目默认是开启状态，旧项目可能被修改过。
• 检查Build Settings的Asset Catalog Compiler - Options：确认Enable On Demand Resources是否被错误开启，该选项会导致非debug模式下资源延迟或无法加载。

2. 全局UIButton配置排查 #

• 找项目里的UIButton全局分类/扩展：比如通过UIButton.appearance()设置了全局的imageEdgeInsets、backgroundImage，或者重写了setImage(_:for:)方法，导致自定义按钮的图片被覆盖或隐藏。
• 检查全局UIAppearance配置：在AppDelegate、SceneDelegate或启动入口代码里，是否对UIButton做了全局样式修改，比如强制设置空图片或透明背景。

3. 编译与Scheme配置对比 #

• 对比新项目和当前项目的Scheme Build Configuration：在Edit Scheme的Run模式下，查看Debug/Release对应的Build Configuration，旧项目可能在Release模式下开启了异常优化。
• 检查Build Settings的Optimization Level：Release模式如果设为Fastest, Smallest [-Os]，可能因代码优化导致图片加载逻辑被误删，可临时改成None [-O0]测试是否恢复。
• 验证Strip Debug Symbols During Copy和Strip Linked Product配置：Release模式下这些选项开启不当，会影响资源引用的正确性。

4. 资源加载逻辑验证 #

• 手动在代码里设置按钮图片：在viewDidLoad中调用button.setImage(UIImage(named: "图片名"), for: .normal)，看非debug模式下能否显示，以此区分是Storyboard配置问题还是资源加载问题。
• 检查图片命名大小写：iOS真机文件系统大小写敏感，模拟器不敏感，旧项目图片命名如果大小写不一致，debug模拟器能兼容，但真机无法识别。

5. 项目缓存与结构检查 #

• 清理项目缓存：执行Command+Shift+K清理Build文件夹，再删除Derived Data（Xcode -> Settings -> Locations -> Derived Data -> 删除对应文件夹），旧项目复制后残留的缓存会导致资源未正确更新。
• 对比project.pbxproj文件：查看新项目和当前项目的资源引用部分，排查是否存在旧target关联或错误的资源路径配置。

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