Swift开发：UIImageView在iPhone X真机不显示，模拟器正常求助

云原生阿岚

2026-5-20

排查iPhone X真机上UIImageView不显示的问题

针对你遇到的「模拟器正常、真机失效，且确认textFieldDidEndEditing已被调用」的情况，给你几个实用的排查方向，你可以逐一验证：

检查图片资源的加载一致性
真机对文件名大小写是严格敏感的，但模拟器不敏感！比如你代码里写UIImage(named: "checkIcon.png")，但实际资源文件是CheckIcon.png，模拟器能正常加载，真机就会返回nil导致imageView空白。
另外要确认图片已经正确加入到项目的target中：打开Xcode的Build Phases -> Copy Bundle Resources，看看你的图片是否在列表里，不在的话点击+添加进去。
确认UI更新在主线程执行
虽然textFieldDidEndEditing回调本身应该在主线程，但有时候某些复杂场景下可能会出现线程偏移。你可以把显示imageView的代码强制包在主线程队列里试试：
```
DispatchQueue.main.async {
    // 你的代码：比如 self.imageView.isHidden = false
    // 或者 self.imageView.image = UIImage(named: "xxx")
}
```
同时打印一下imageView的关键属性：print(imageView.frame, imageView.isHidden, imageView.image)，看看是不是尺寸为0、被隐藏，或者image本身就是nil。
排查UITableViewCell的复用问题
你提到在cellForRow和textFieldDidEndEditing里都用了这段代码，很可能是cell复用导致的状态混乱：
1. 在cellForRow里一定要重置imageView的初始状态，比如默认隐藏或者设置image为nil，避免复用旧cell的状态；
2. 确保在textFieldDidEndEditing里操作的是当前编辑的textField所在的cell——不要用textField.superview?.superview这种不稳定的方式找cell，建议给textField添加关联对象存储对应的indexPath，或者通过代理把indexPath传递过来，再用tableView.cellForRow(at: indexPath)获取目标cell。
验证图片格式与兼容性
有些特殊格式的图片（比如WebP）在真机上需要额外处理才能识别，或者图片的颜色空间、分辨率不兼容。你可以把图片转换成标准的PNG/JPG格式，重新导入项目后再测试。
核对模拟器与真机的iOS版本
检查一下你的iPhone X真机和模拟器的iOS版本是否一致，如果版本差异较大，某些UI相关的API行为可能会有变化。比如你用了某个iOS 16才支持的contentMode属性，而真机是iOS 15，就会导致显示异常。

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