Gradle Project Sync Failed：可尝试 gradlew -v_sync project with gradle files 失败

关键词：工程目录结构看起来奇怪、没法新建 class，Sync Project with Gradle Files；Gradle Project Sync Failed，gradlew -v、GRADLE_USER_HOME。

一、新建工程目录的结构看起来奇怪、没法新建 class：要 Sync Project with Gradle Files

今天新建了一个 Android Project (Phone and Tablet > Empty Activity)，发现工程结构长这样，就是简单把文件目录展示出来：

看起来与平时习惯的样子不一样（这是另一个工程的截图）：

而且右键还没法新建 class ，只能新建普通文件。如果换作其它 IDE，首先想到的解决方案可能是：右键菜单 > Mark Directory as > Sources Root，然而会发现工程结构更混乱了，而且这一步好像还没法撤销？？？

根据 《AndroidStuido 突然不识别 项目no moudle》 (https://blog.csdn.net/mp624183768/article/details/103804227) ，得知解决办法是 菜单栏 File > Sync Project with Gradle Files。

二、Gradle project sync failed

这时又注意到，其它地方其实也在提示 Gradle project sync failed。

网上搜到的一些解决方案，主要是讲 gradle-wrapper.properties 文件中的 distributionUrl 这一键值对的修改，涉及 gradle 版本之类的问题，我检查却发现一切正常。

在 Android Studio 底部的 Terminal 中，执行命令 gradlew -v，发现报错：
Exception in thread "main" java.lang.RuntimeException: Could not create parent directory for lock file ......\gradle_user_home\wrapper\dists\gradle-5.4.1-all\......\gradle-5.4.1-all.zip.lck

那么就检查这个路径有没有问题（比如移动硬盘没插好……），解决。

三、进一步探究

经实验，这个路径就是操作系统环境变量 GRADLE_USER_HOME （修改环境变量后需重启 Android Studio 就可看到报错有变化）。

猜想的结论：系统环境变量 GRADLE_USER_HOME 优先级高于从网上下载，所以如果 GRADLE_USER_HOME 存在但是有问题，按网上其它解决方案去改 distributionUrl 可能也没用？？

《Android Studio 配置Gradle总结》(https://www.cnblogs.com/freewsf/p/11232273.html) 介绍了 Android Studio 对 gradle 的配置。