新建Android项目Gradle同步报错：发现无效XML字符(Unicode:0x0)

问题分析 #

全新Android项目未做任何修改却出现该报错，大概率是**不可见的空字符（Unicode 0x0）**混入了项目配置文件、Gradle缓存或系统临时文件中，和你删除XML文件的操作无关——默认项目的XML文件都是合法的，删它们没用。

分步解决方法 #

• 清理Android Studio缓存并重启
  操作路径：File > Invalidate Caches...，勾选Invalidate and Restart选项后重启IDE。缓存文件容易残留异常字符，清理后能解决多数无厘头的编译问题。

• 重置本地Gradle资源
  找到用户目录下的.gradle文件夹：

  • Windows：C:\Users\<你的用户名>\.gradle
  • Mac/Linux：~/.gradle
    删除其中的caches和wrapper子文件夹，回到Android Studio重新执行Gradle同步，让IDE重新下载干净的Gradle文件。

• 检查项目核心配置文件
  用支持显示所有字符的文本编辑器（比如Notepad++、VS Code）打开项目根目录的settings.gradle、项目级build.gradle，开启"显示所有字符"功能，查找并删除隐藏的空字符，保存后重新同步。

• 换纯英文路径重建项目
  避免使用包含中文、空格或特殊符号的目录，新建项目时选择纯英文路径（比如D:\Android_Projects\DemoApp），再尝试同步Gradle。旧路径可能被系统残留的异常字符污染。

• 清理系统临时文件
  清理系统临时文件夹：

  • Windows：按下Win+R输入%TEMP%，删除文件夹内所有文件
  • Mac/Linux：终端执行rm -rf /tmp/*（注意：不要误删正在使用的重要文件）
    清理后回到IDE重新同步。

内容的提问来源于stack exchange，提问作者Bourgeois Old man