优先选D盘或其他非系统盘的固定路径,比如D:gradle-8.10;C盘用户目录或系统盘根目录易导致空间紧张、权限受限、重装丢失配置。

Gradle安装路径选C盘还是D盘
直接说结论:**别装C盘用户目录(如C:Usersxxx.gradle)或系统盘根目录,优先选D盘或其他非系统盘的固定路径,比如D:gradle-8.10**。C盘空间紧张、权限受限、重装系统易丢配置,是Windows下Gradle最常被忽视的隐患点。
为什么不能用默认解压路径(如桌面或下载文件夹)
很多人图省事,双击下载包直接解压到桌面或Downloads,结果遇到三类问题:
-
gradle -v报错“不是内部或外部命令”,因为路径含空格或中文(如C:Users张三Downloadsgradle-8.10-bin.zip)导致环境变量解析失败 - 后续IDEA或Android Studio识别不到Gradle,因路径太深或有特殊字符,触发JVM启动参数截断
- 项目切换版本时,不同
gradle-7.6、gradle-8.5混在同一个文件夹里,手动删错版本引发构建失败
正确做法是:解压后剪切到一个**全英文、无空格、层级浅**的路径,例如:D:gradle-8.10、C:devgradle-7.6(注意不是C:Program Filesgradle-8.10,那个位置需要管理员权限才能写入)。
GRADLE_HOME必须指向解压后的根目录,不是bin子目录
设置环境变量时,GRADLE_HOME的值必须是解压后最外层文件夹,即包含bin/、lib/、init.d/等子目录的那个目录。常见错误包括:
- 设成
D:gradle-8.10in→gradle -v会提示找不到gradle.jar - 设成
D:gradle-8.10-bin(带-bin后缀)→ 实际解压后文件夹名是gradle-8.10,名字对不上就找不到 - 路径末尾加了反斜杠
→ 某些旧版PowerShell会把%GRADLE_HOME%in拼成D:gradle-8.10\bin,多一个也可能出问题
验证方式很简单:打开CMD,执行echo %GRADLE_HOME%,输出应严格等于你解压的完整路径,且能手工进入该路径下的bin目录看到gradle.bat。
多个Gradle版本共存时的目录组织建议
如果你同时维护老Android项目(需gradle-6.5)和新Kotlin项目(用gradle-8.10),推荐按版本号分文件夹存放:
D:gradlegradle-6.5D:gradlegradle-7.6D:gradlegradle-8.10
然后通过修改GRADLE_HOME快速切换,比反复下载解压省事。注意不要把不同版本混在同一个文件夹里——Gradle不会自动区分,它只认GRADLE_HOME指向的那个。
真正容易被忽略的是:GRADLE_USER_HOME(本地仓库路径)和GRADLE_HOME(安装路径)完全独立,前者可以统一设为D:gradle-repo,避免每个版本都重复下载依赖。


















