iOS App部署问题：Xcode调试与TestFlight安装后UIImage分辨率不一致

以下是针对Debug构建图片清晰、TestFlight/App Store构建图片模糊问题的排查方向和解决方案：

1. 检查Asset Catalog的图片压缩设置 #

打开Assets.xcassets选中对应Image Set，查看右侧属性面板：

• 将Compression选项从默认的Automatic改为Lossless或None，重新打包上传TestFlight测试。自动压缩在Production构建中可能会过度降低图片质量，而Debug构建通常不会启用高强度压缩。
• 若使用PDF矢量图，确保Preserve Vector Data已勾选，避免Production构建时被栅格化为低分辨率位图。

2. 核对Build Settings中的Asset编译选项 #

在Xcode的Build Settings中搜索Asset Catalog Compiler - Options，确保Debug与Production配置一致：

• 检查Compress PNG Files、Compress JPEG Files：若Production开启了更高压缩级别，将其调整为与Debug相同的设置（比如都设为NO）。
• 确认Optimize PNG Files和Asset Catalog Compiler: Optimize Images：Production构建可能默认开启优化，导致图片质量下降，可尝试将这两项设为NO后重新Archive。
• 搜索Enable HEIC Conversion，设置为NO，避免Xcode将图片自动转换为HEIC格式导致兼容性或质量问题。

3. 验证Archive包中的图片实际质量 #

将Archive导出为IPA文件，解压后通过Xcode自带的assetutil工具查看Assets.car中的图片信息：

# 进入包含Assets.car的目录
cd Payload/YourApp.app/
# 导出图片信息到JSON
assetutil --info Assets.car > assets.json

打开assets.json，对比对应图片的Pixel Width/Pixel Height和文件大小，与Debug包中的图片参数做对比，确认是否是Production构建时被压缩降级。

4. 排查App Thinning或按需资源设置 #

检查是否误将图片标记为On-Demand Resources，导致Production版本下载的是适配其他设备的低分辨率资源。在Assets.xcassets中确认所有图片的Resource Tags未设置为按需加载。

5. 确认原始图片分辨率 #

确保导入Asset Catalog的图片是对应设备的高分辨率版本（iPhone 12 Pro Max为3x屏，图片尺寸需满足3x规格）。若使用Single Scale模式，需保证图片分辨率足够覆盖设备屏幕，避免拉伸后在Production压缩下更模糊。

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