Android Studio同步build.gradle提示项目非Gradle项目如何解决

报错提示：The project 'ProjectName' is not a Gradle-based project

按照如下步骤逐一排查即可：

• 检查根目录Gradle配置文件完整性：确认项目根目录下存在settings.gradle（或settings.gradle.kts）、gradle.properties、gradlew、gradlew.bat文件，以及gradle文件夹。如果缺失上述文件，从同版本的正常Android Gradle项目中复制对应文件到根目录，重启Android Studio后重试同步。
• 修正项目导入方式：不要直接选择「打开文件夹」加载项目，点击菜单栏File > New > Import Project，选中项目根目录下的build.gradle文件后确认导入，选择使用Gradle Wrapper完成构建。
• 清除IDE缓存重启：点击菜单栏File > Invalidate Caches...，勾选「Clear file system cache and local history」，点击「Invalidate and Restart」，等待IDE重启后重新触发同步。
• 重置IDE项目配置：关闭Android Studio，删除项目根目录下的.idea隐藏文件夹，以及所有模块目录下的.iml配置文件，重新打开项目等待IDE自动生成配置后重试同步。
• 检查Gradle版本兼容性：打开gradle/wrapper/gradle-wrapper.properties文件，确认distributionUrl字段指定的Gradle版本，与当前Android Studio版本的支持范围匹配，若版本过旧可更换为适配的Gradle版本后重试。

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