您现在的位置：程式碼之家 >> 編程語言 > >> 更多程式語言 >> 程式設計綜合問答

Android Studio 安裝常見問題：JDK 路徑配置與環境驗證指南

編輯：程式設計綜合問答

錯誤現象

Android Studio 安裝或首次運行時提示「找不到 JDK」或「JDK 版本不兼容」，常見原因是 JDK 安裝路徑包含空格或中文，或環境變量配置錯誤。

核心解決步驟

1. JDK 重新安裝 (關鍵)

路徑原則：不含空格、不含中文、路徑盡量短
推薦路徑：`C:\Java\jdk-17` 或 `D:\Dev\JDK\jdk-21`
避免路徑：`C:\Program Files\Java\jdk-17` (含空格)、`C:\Program Files (x86)\Java\` (含括號空格)

2. 環境變量標準配置

變量名	值示例	說明
`JAVA_HOME`	`C:\Java\jdk-17`	JDK 安裝根目錄 (含 bin、lib 目錄)
`PATH`	`%JAVA_HOME%\bin;%PATH%`	將 JDK bin 目錄加入系統路徑建議放在最前面
`CLASSPATH`	`.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar`	可選，現代 Java 通常不需要

注意：直接在 `PATH` 中使用 `%JAVA_HOME%\bin` 而非硬編碼路徑，方便日後升級 JDK 只需修改 `JAVA_HOME`。

3. 命令行驗證安裝

C:\Users\Admin> java -version
java version "17.0.9" 2023-10-17 LTS
Java(TM) SE Runtime Environment (build 17.0.9+8-LTS-211)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.9+8-LTS-211, mixed mode, sharing)

C:\Users\Admin> javac -version
javac 17.0.9

若提示「不是內部或外部命令」，說明 `PATH` 配置未生效，需重啟 CMD/PowerShell 或檢查變量拼寫。

4. Android Studio 內部 JDK 設置

打開 File > Settings > Build, Execution, Deployment > Build Tools > Gradle > Gradle JDK
選擇 JAVA_HOME 或手動指向 JDK 目錄
同步項目：File > Sync Project with Gradle Files

常見錯誤與解決

錯誤提示	原因	解決
「The JAVA_HOME environment variable is not set correctly」	JAVA_HOME 指向 JRE 而非 JDK，或路徑錯誤	指向 JDK 根目錄 (含 bin/javac.exe)
「JDK version 1.8 is not supported」	AGP 8.0+ 要求 JDK 17+	升級 JDK 17/21，更新 Android Studio 至最新版
「Could not find tools.jar」	JDK 安裝不完整或路徑錯誤	重新安裝 JDK 完整版 (非 JRE)
Gradle Sync Failed: "Unsupported class file major version 61"	JDK 版本與 Gradle/Android Gradle Plugin 不匹配	對照 Gradle 兼容性矩陣選擇正確 JDK

進階建議

多版本管理：使用 jvms、SDKMAN! 或手動設置多個 `JAVA_HOME_17`、`JAVA_HOME_21` 切換
項目級配置：在項目根目錄創建 `gradle.properties` 指定 `org.gradle.java.home=C:/Java/jdk-17`，不依賴全局環境
嵌入式 JDK：Android Studio 4.2+ 自帶 JDK (jbr)，可直接選用無需單獨安裝，路徑通常在安裝目錄 `/jbr`