使用libGDX生成Java项目失败，报Unsupported class file major version 63错误

问题根源 #

报错里的Unsupported class file major version 63表示当前使用的Gradle 7.5.1版本不兼容你系统中的Java版本——major version 63对应Java 19，而Gradle 7.x系列最高仅支持到Java 18，Java 19需要Gradle 8.0及以上版本才能适配。

解决方案 #

方案1：降级Java版本 #

• 安装Gradle 7.5.1支持的Java版本（推荐长期支持版Java 17）
• 配置环境让Gradle使用该版本：
  • 系统层面：设置JAVA_HOME指向Java 17的安装目录
  • 项目层面：在项目根目录创建gradle.properties文件，添加：

    org.gradle.java.home=/path/to/java17
    

方案2：升级Gradle版本 #

• 打开项目根目录的gradle/wrapper/gradle-wrapper.properties文件
• 修改distributionUrl为Gradle 8.0及以上版本的地址，例如：

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

• 重新执行项目构建命令

方案3：重新通过libGDX生成器创建项目 #

• 打开libGDX项目生成器，在"Advanced"选项中选择与你的Java版本匹配的Gradle版本：
  • Java 19+选Gradle 8.0+
  • Java 18及以下可选Gradle 7.x

内容的提问来源于stack exchange，提问作者Richard Coterie