Android Studio 安裝報錯排查指南：常見原因與解決方案

常見報錯類型與對策

1. JDK 版本不匹配

• 現象：啟動畫面閃退、提示 Failed to find JVM 或版本號紅字。
• 原因：系統預設 JDK 非 8/11/17 LTS 版，或 JAVA_HOME 指向錯誤路徑。
• 解決：安裝 JDK 17（推薦），設定 JAVA_HOME 並加入 PATH；在 studio64.exe.vmoptions 指定 -Djdk.home=...。

2. SDK/NDK 路徑包含中文或特殊字元

• 現象：Gradle 同步失敗、aapt2 執行錯誤。
• 解決：將 Android SDK 安裝至純英文路徑（如 D:\\Android\\Sdk），避免空格、中文、括號。

3. 版本不相容：IDE、Gradle Plugin、Gradle、Kotlin 三版本矩陣

• 現象：專案建立後 Build failed、Unsupported class file major version。
• 對策：查閱 官方版本對應表，統一升級或降級至相容組合。新專案建議使用最新穩定版組合。

4. 網路/代理導致依賴下載失敗

• 現象：Gradle 卡在 Downloading ...、Connection timed out。
• 解決：配置 gradle.properties 代理、使用阿里雲/騰訊雲 Maven 鏡像、離線模式預下載依賴。

5. 硬體加速 / Hyper-V 衝突（Windows）

• 現象：模擬器啟動黑屏、emulator: ERROR: x86 emulation requires hardware acceleration。
• 解決：BIOS 開啟 VT-x/AMD-V，關閉 Hyper-V（bcdedit /set hypervisorlaunchtype off 重啟），或改用 ARM64 映像檔。

通用排查步驟

1. 查看 idea.log（Help → Show Log in Explorer/Finder）完整堆疊追蹤。
2. File → Invalidate Caches / Restart 清理索引緩存。
3. 刪除 .gradle、.idea、build 目錄重新導入專案。
4. 以管理員身份執行安裝程式/IDE。

總結

「版本裝錯」確是高頻原因，但更多是環境變數、路徑、網路、版本矩陣綜合問題。建議按上述清單逐項核對，並保留安裝日誌供社群求助時參考。