Debian上APT安装Gradle版本严重滞后（如Trixie仅提供4.4.1），无法满足现代项目需求；推荐手动解压配置（适用于生产/CI）或SDKMAN多版本管理（适用于本地开发），并严格校验JDK 17–21兼容性。
Debian上用apt装不了指定Gradle版本
Debian官方源里的gradle包长期滞后——比如Debian 13（Trixie）默认只有4.4.1，而当前稳定版已是9.2.1。直接sudo apt install gradle几乎必然不满足项目要求，尤其当你需要匹配Android Gradle Plugin 8.7+或Java 21环境时。
真正可控的方式只有两种：手动解压配置，或用SDKMAN管理。APT只适合临时验证或CI基础镜像等低精度场景。
手动安装指定版本（推荐用于生产/CI环境）
关键点不是“下载”，而是路径规范、权限控制和环境变量生效时机。常见失败不是命令错，而是~/.bashrc没重载，或/opt/gradle目录权限被unzip继承破坏。
- 下载对应
bin.zip包（如gradle-9.2.1-bin.zip），避免-all.zip或-src.zip - 解压到
/opt/gradle并创建软链接：sudo unzip gradle-9.2.1-bin.zip -d /opt/gradle && sudo ln -sf /opt/gradle/gradle-9.2.1 /opt/gradle/latest - 在
~/.bashrc（或~/.zshrc）末尾添加两行：export GRADLE_HOME=/opt/gradle/latestexport PATH=$GRADLE_HOME/bin:$PATH - 执行
source ~/.bashrc，然后用which gradle确认路径是否指向/opt/gradle/latest/bin/gradle
SDKMAN切换多版本（推荐用于本地开发）
如果你同时维护多个Java项目，有的用7.6，有的必须8.14.2，手动改GRADLE_HOME极易出错。SDKMAN本质是shell函数+版本目录隔离，比写脚本更轻量可靠。
- 先装SDKMAN：
curl -s "https://get.sdkman.io" | bash，然后source "$HOME/.sdkman/bin/sdkman-init.sh" - 运行
sdk list gradle查看可用版本；注意8.14.2和9.2.1都已收录，但9.0以下某些版本可能标为deprecated - 安装并设为默认：
sdk install gradle 9.2.1 && sdk default gradle 9.2.1 - 验证：
gradle -v输出的版本号应与你指定的一致，且echo $GRADLE_HOME会显示SDKMAN管理的路径（如~/.sdkman/candidates/gradle/9.2.1）
为什么gradle -v成功但项目里仍报错？
最常被忽略的是JDK兼容性。Gradle 9.x要求JDK 17–21，而Debian默认java -version可能仍是OpenJDK 11。即使gradle -v能跑，构建时buildSrc或插件初始化阶段仍会因JVM版本不匹配崩溃，错误信息类似：Unsupported class file major version 65（对应JDK 21字节码）。
务必检查：java -version输出的JDK主版本号gradle -v输出中Launcher JVM和Daemon JVM字段是否一致且符合要求
必要时用export JAVA_HOME=/usr/lib/jvm/temurin-21-jdk-amd64强制指定
