Android Studio Gradle Build Running 卡死：缺失 v7/design 依賴與 Wrapper 版本修正

故障現象

新建項目後長時間停留在「Gradle Build Running」，渲染器報錯，VPN 已開但無效。

根因定位

1. 缺失 AndroidX/AppCompat 依賴：渲染器找不到 Theme.AppCompat 等基礎主題
2. Gradle Wrapper 版本不匹配：項目指定版本與本地分發不一致

修復步驟

1. 補全依賴 (build.gradle - Module:app)

dependencies {
    implementation 'androidx.appcompat:appcompat:1.6.1'
    implementation 'com.google.android.material:material:1.10.0'
    // 其它依賴...
}

快捷鍵 Ctrl+; (Project Structure) → Dependencies → + → Library dependency 搜索添加。

2. 修正 Wrapper 版本 (gradle/wrapper/gradle-wrapper.properties)

distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-all.zip

建議使用穩定長期支持版本（如 8.4），避免過新/過舊版本兼容性問題。

3. 同步與重建

• File → Sync Project with Gradle Files
• Build → Clean Project → Rebuild Project

網絡加速提示

• 配置 Gradle 鏡像：gradle.properties 添加 distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.4-all.zip
• Maven 鏡像：settings.xml 配置阿里云/騰訊云鏡像

AS 新建項目模板有時不全，養成檢查依賴與 Wrapper 版本的習慣，能省去 90% 的初始化卡頓。