Android Studio中values.xml资源编译错误排查求助

• 检查颜色值格式合法性
  确认#0cffffff的写法符合Android颜色规范：Android支持#RGB、#ARGB、#RRGGBB、#AARRGGBB四种格式，8位的#AARRGGBB是合法的，但要排查是否存在输入失误——比如多写/漏写字符、透明度与颜色值顺序颠倒（比如误写为#ffffff0c）。可以临时将该颜色值替换为标准测试值（如#FF0000），重新编译验证是否由该颜色值本身导致错误。

• 查看详细编译日志
  默认错误提示信息有限，通过以下方式获取完整日志：

  1. 在Android Studio中点击Build -> View Build Output，定位mergeDebugResources任务的完整报错内容，里面会明确标注具体问题（如标签语法错误、资源重复定义等）。
  2. 终端执行命令：./gradlew assembleDebug --info，输出详细编译日志后，搜索values.xml相关条目，精准定位错误根源。

• 检查values.xml的语法与结构
  打开报错的values.xml文件，重点检查#0cffffff所在行及附近的XML结构：

  • 确认标签是否正确配对，有无遗漏>或</>符号、标签嵌套错误。
  • 检查周围资源定义的语法（如字符串是否闭合引号、标签属性是否正确）。
  • 验证文件编码为UTF-8（Android Studio右下角可查看/修改编码），编码异常会导致资源解析失败。

• 清理缓存并重建项目
  缓存损坏常引发诡异的编译错误，执行以下操作：

  1. 点击Build -> Clean Project，再选择Build -> Rebuild Project。
  2. 手动删除项目根目录下的.gradle文件夹、app/build文件夹，然后点击File -> Sync Project with Gradle Files重新同步项目。

• 排查资源冲突或重复定义

  • 检查其他values目录（如values-v21、values-night）是否存在同名资源，导致合并时冲突。
  • 排查近期新增的第三方依赖，是否与项目内资源重名。可暂时移除第三方依赖，验证编译是否恢复正常。

• 验证Gradle插件与SDK版本兼容性
  检查项目根目录build.gradle中的Android Gradle插件版本，以及app/build.gradle中的compileSdk、targetSdk版本是否匹配。版本不兼容可能引发资源编译异常，可尝试切换到稳定版本（如插件用7.4.2，compileSdk用33）。

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