Xcode 14构建报错：读取Asset Tags失败，请求帮助

问题重现 #

使用Xcode 14构建项目时触发以下错误：

error build: failed to read asset tags: 执行命令(cd /Users/anais/Downloads/Cronometraje && /Applications/Xcode.app/Contents/Developer/usr/bin/actool --print-asset-tag-combinations --output-format xml1 /Users/anais/Downloads/Cronometraje/Cronometraje/Assets_Pro.xcassets)后退出状态为1

actool输出的错误核心提示：

JSON text did not start with array or object and option to allow fragments not set. around line 1, column 0.

问题原因 #

本质是Assets_Pro.xcassets目录下存在格式损坏的JSON配置文件（大多是各资源子文件夹里的Contents.json），导致actool无法正常解析资源标签。

解决步骤 #

• 检查Assets_Pro.xcassets下的所有Contents.json文件
  逐个打开目录里每个资源（图片、颜色、图标等）子文件夹中的Contents.json，排查是否有空文件、内容为空，或者语法错误（比如开头不是{/[、括号不匹配、逗号多余/缺失）。
• 修复或替换损坏的JSON文件
  若发现某文件格式错误，要么手动修正语法，要么从备份复制正确的Contents.json，无用资源可直接删除对应文件夹。
• 清理Xcode缓存后重建
  1. 按下Cmd+Shift+K清理项目构建缓存
  2. 关闭Xcode，删除DerivedData目录（路径：~/Library/Developer/Xcode/DerivedData）
  3. 重新打开项目执行构建
• 排查第三方资源问题
  如果最近导入过第三方资源包，先移除这些资源再尝试构建，确认是否是第三方资源的配置文件引发的问题。

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