Xcode克隆项目后Assets.xcassets部分图片显示Unassigned求助

这个问题我之前帮不少开发者排查过，在Xcode 9.x尤其是9.3版本里属于比较典型的Assets Catalog版本控制问题，根因主要集中在以下几点：

• Assets元数据文件未完整提交
  你看到的图片本身虽然提交了，但Xcode的Assets Catalog里每个图片资源对应的.imageset文件夹里，还有个关键的Contents.json文件——它记录了图片的缩放倍率（1x/2x/3x）、归属状态等核心信息。如果提交时漏掉了这个文件，或者它被Git忽略了，克隆项目后Xcode就没法识别图片的正确配置，只能标记为Unassigned。

• Xcode 9.3的Assets Catalog缓存缺陷
  Xcode 9.3版本在处理版本控制后的Assets Catalog加载时，存在本地缓存逻辑的bug。哪怕Contents.json已经正确提交，克隆项目后Xcode可能会读取旧的缓存数据，导致误判图片的分配状态。这个问题在后续的Xcode 9.4及更高版本中已经被苹果修复了。

• Git忽略规则的误配置
  检查你的项目根目录下的.gitignore文件，是不是不小心添加了排除*.imageset/Contents.json或者.imageset文件夹部分内容的规则？如果有这类规则，会直接导致元数据文件无法被提交到远程仓库，克隆自然就缺失这部分配置信息。

对应的修复方案 #

针对上面的根因，你可以按以下步骤解决：

1. 检查并修复Contents.json文件
   找到有问题的图片对应的.imageset文件夹，确认里面存在Contents.json，并且文件内容里的images数组正确包含了对应缩放倍率的条目，比如：

   {
     "images" : [
       {
         "idiom" : "universal",
         "filename" : "logo.png",
         "scale" : "1x"
       },
       {
         "idiom" : "universal",
         "filename" : "logo@2x.png",
         "scale" : "2x"
       }
     ],
     "info" : {
       "version" : 1,
       "author" : "xcode"
     }
   }
   

   如果文件缺失或者内容错误，直接在Xcode里重新拖拽图片到对应倍率位置，它会自动生成正确的Contents.json。

2. 提交元数据文件到Git
   打开终端，进入项目目录，执行以下命令把Contents.json添加并提交：

   git add ./YourProject/Assets.xcassets/ProblemImage.imageset/Contents.json
   git commit -m "Fix missing Contents.json for unassigned assets"
   git push origin main
   

   （把路径换成你实际的项目路径和分支名）

3. 修正Git忽略规则
   打开.gitignore文件，查找是否有类似*.imageset/Contents.json或者*.xcassets/*/.json的规则，如果有就删除这些行，确保元数据文件能被Git追踪。

4. 清理Xcode缓存（针对缓存bug）
   如果是Xcode缓存导致的问题，克隆项目后先关闭Xcode，然后通过Xcode -> Preferences -> Locations -> Derived Data找到缓存路径，删除整个Derived Data文件夹，再重新打开项目，Xcode会重新加载Assets Catalog的配置。

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