从Eclipse迁移至Android Studio的项目，Mac终端执行Gradle构建失败

嘿，刚碰到过类似的Eclipse转Android Studio后终端Gradle踩坑情况，给你几个靠谱的排查步骤，应该能解决：

1. 优先使用项目自带的Gradle Wrapper #

Android Studio里构建用的是项目根目录的Gradle Wrapper（gradlew脚本），而你直接敲gradle调用的是系统全局安装的版本，大概率和项目依赖的Gradle版本不兼容，这是最常见的问题：

• 放弃全局gradle命令，在项目根目录执行：./gradlew tasks
• 想确认版本匹配度的话，对比：
  • 终端全局版本：gradle -v
  • 项目依赖版本：查看gradle/wrapper/gradle-wrapper.properties里的distributionUrl，比如https\://services.gradle.org/distributions/gradle-7.5-bin.zip对应7.5版本

2. 对齐终端与Android Studio的环境变量 #

终端的JAVA_HOME、ANDROID_HOME可能和AS用的不一样，导致依赖找不到：

• 先查AS的JDK路径：打开AS → Preferences → Build, Execution, Deployment → Build Tools → Gradle，复制「Gradle JDK」的路径
• 终端检查当前JAVA_HOME：echo $JAVA_HOME，如果不一致，修改终端配置文件（比如.zshrc或.bash_profile）：

  export JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home"
  export PATH="$JAVA_HOME/bin:$PATH"
  

• 同样对齐ANDROID_HOME：AS里看Preferences → Appearance & Behavior → System Settings → Android SDK的路径；终端添加：

  export ANDROID_HOME="$HOME/Library/Android/sdk"
  export PATH="$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools:$PATH"
  

• 修改后执行source ~/.zshrc（对应你的配置文件）生效

3. 清理迁移残留的缓存文件 #

迁移后残留的缓存会干扰终端构建，彻底清理后重试：

• AS里执行：Build → Clean Project → Rebuild Project
• 终端进入项目根目录，删除缓存文件夹：

  rm -rf .gradle/ build/
  

• 再执行./gradlew clean tasks测试

4. 检查项目Gradle配置的迁移残留 #

Eclipse的配置可能没清理干净，导致Gradle解析失败：

• 打开项目根目录的build.gradle，确认buildscript依赖的Android Gradle Plugin版本和Gradle版本匹配（比如AGP 7.4.2对应Gradle 7.5+）：

  buildscript {
      repositories {
          google()
          mavenCentral()
      }
      dependencies {
          classpath 'com.android.tools.build:gradle:7.4.2'
      }
  }
  

• 检查模块的build.gradle，移除Eclipse特有的配置（比如apply plugin: 'eclipse'）

如果以上步骤都试过还是不行，把错误堆栈里「What went wrong」后面的具体报错信息贴出来，能更快定位问题～

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