一、为什么UIImage(named:)加载XCAssets里的HEIC会返回nil？ #

你遇到的问题本质是XCAssets对HEIC资源的默认配置可能没有正确适配，导致系统无法正确索引到HEIC格式的资源。要解决这个问题，需要按以下步骤配置：

二、正确配置XCAssets中的HEIC资源（兼容App Thinning） #

1. 导入多分辨率HEIC资源

   • 准备对应分辨率的HEIC图片（比如stone@2x.heic、stone@3x.heic），将它们分别拖入XCAssets中同一个图片asset的2x、3x分辨率槽位里。
   • 确保每个槽位里的图片都是HEIC格式，不要混合其他格式。

2. 调整Asset的属性设置

   • 选中该图片asset，打开右侧的Attributes Inspector：
     • 将Type设置为Image，Scales选择Scale Factors（这是开启App Thinning的关键，系统会根据设备分辨率只打包对应版本的资源）；
     • 将Render As设置为Original Image，避免系统自动将HEIC转换为PNG或其他格式。

3. 修改Build Settings确保HEIC格式保留

   • 在项目的Build Settings中，搜索Asset Catalog Compiler - Options：
     • 将Optimize Images设置为YES，Xcode会保留HEIC的压缩格式，不会强制转成PNG；
     • 确保Compress PNG Files设置为NO（如果你的asset里没有PNG资源，这个选项影响不大，但关闭可以避免误处理HEIC）。

完成以上配置后，再调用UIImage(named: "stone")就能正常加载HEIC图片了，而且App Thinning会自动生效——比如iPhone 7这类2x分辨率设备，只会打包并加载stone@2x.heic，不会包含3x版本。

三、Interface Builder中HEIC图片加载的内部机制 #

你提到IB中直接设置图片名称就能加载HEIC，这是因为IB的编译和运行时加载流程和手动调用UIImage(named:)有细微差异：

1. 编译阶段的验证
   IB在编译storyboard/nib文件时，会直接读取XCAssets的资源索引，验证HEIC资源的存在性和格式正确性，并且会将图片名称关联到对应的asset ID，而不是依赖文件路径。

2. 运行时的加载逻辑
   当nib/storyboard被解码时，系统会调用UIImage(named: in: compatibleWith:)这个方法（而不是简单的UIImage(named:)），这个方法会优先从XCAssets的优化资源库中查找，内部已经处理了HEIC格式的识别和解析，所以能正确加载。

简单来说，IB的加载流程更贴近系统对XCAssets资源的原生处理逻辑，而如果你的XCAssets配置有误（比如格式被转换、分辨率槽设置错误），手动调用UIImage(named:)就会找不到资源返回nil，但IB在编译阶段就会帮你规避部分配置问题。

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