Android Studio Gradle 同步失敗常見解決方法

錯誤現象

Gradle 同步報錯，常見提示：`Failed to resolve dependency`、`Could not find method`、`SDK location not found` 等。

三大通用解決步驟

1. Clean Project：`Build > Clean Project` 清理舊構建產物。
2. Sync Project with Gradle Files：工具欄右側小象形圖（或 `File > Sync Project with Gradle Files`）強制重新解析腳本。
3. 更新 SDK/Build Tools：`Tools > SDK Manager` 安裝項目 `build.gradle` 指定的 `compileSdkVersion`、`buildToolsVersion` 對應版本。

進階排查

• 檢查 `gradle-wrapper.properties` 中 `distributionUrl` 是否可訪問（需翻牆或使用阿里云鏡像）。
• 刪除 `.gradle`、`build` 目錄後 Rebuild。
• 查看 `Gradle Console` 輸出具體錯誤行，定位依賴版本衝突或語法錯誤。

參考鏈接

Android Studio Gradle 同步失敗完整解決指南