解决Windows用户名含非ASCII字符导致的Android Studio AAPT2错误

兄弟，我之前也碰到过一模一样的AAPT2路径乱码问题，完全懂你不想回退到旧版aapt的心情！下面给你拆解问题和靠谱的解决方案：

一、AAPT2错误日志的查看位置 #

• Android Studio内：直接看底部的Build面板，切换到Build Output标签就能看到完整的报错细节；要是面板没显示，通过View > Tool Windows > Build调出来就行。
• 命令行层面：你执行gradlew clean assembleDebug时终端输出的内容就是最直接的日志，那些“文件未找到”的信息就是定位问题的关键线索。

二、报错的核心原因 #

从你说的路径乱码（比如C:\Users\M?tz\...）来看，问题根源是你的Windows用户名包含非ASCII特殊字符（比如德语的变音字符ü，或者中文、其他带重音的字母）。AAPT2在解析这类路径时，编码处理出了问题，导致找不到项目依赖、资源文件等，所以才会触发一堆重复的“文件未找到”错误。
而且新建示例项目也报错，说明这不是你写的代码有问题，是系统用户目录的编码和AAPT2不兼容导致的环境问题。

三、保留AAPT2的修复方案 #

1. 快速临时方案：转移Gradle缓存路径 #

不用改系统账户，直接把Gradle的缓存目录移到不含特殊字符的路径下就行：

• 打开gradle.properties文件（可以是项目根目录下的，也可以是用户目录.gradle文件夹里的全局配置文件）
• 添加这行配置（把路径换成你电脑上纯英文的路径，比如D盘下的文件夹）：

  GRADLE_USER_HOME=D:\Gradle_Cache
  

  保存后，重新执行gradlew clean assembleDebug，Gradle会自动在新路径下载所有依赖，AAPT2就能正常识别路径了。

2. 彻底根治方案：更换Windows用户账户 #

如果想一劳永逸解决这个问题，可以创建一个用户名全是ASCII字符（纯英文数字）的新Windows账户，然后在新账户下重新安装Android Studio、导入项目。这个方法最彻底，但需要迁移你的个人文件，操作前一定要做好备份！

3. 验证修复效果 #

改完之后再跑一遍gradlew clean assembleDebug，如果不再出现路径乱码和文件找不到的错误，就说明修复成功了。

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