1. 引言在现代 Java 项目开发中尤其是在持续集成/持续部署CI/CD流水线、多模块项目或团队协作场景下确保开发、测试和生产环境使用统一且正确的 JDK 版本至关重要。手动下载、安装和配置不同版本的 JDK 不仅繁琐而且容易出错。幸运的是通过使用java-version和distribution参数我们可以灵活、自动化地设置所需的 JDK 环境。2. 核心参数解析2.1 java-version 参数java-version参数用于指定所需的 Java 版本。其值可以是具体的版本号如17,11,1.8也可以是版本范围如17或最新的 LTS 版本标识如lts。精确版本例如java-version: 17将确保环境使用 JDK 17。版本范围例如java-version: 11将使用 JDK 11 或更高版本优先选择 11。LTS 版本例如java-version: lts将自动选择当前可用的最新长期支持版本。2.2 distribution 参数distribution参数用于指定 JDK 的发行版。不同的发行版在性能、许可协议和附加工具上可能有所差异。常见的发行版包括temurin由 Adoptium 社区提供的 Eclipse Temurin是广泛使用的开源发行版。zuluAzul Zulu基于 OpenJDK提供免费版本和商业支持。correttoAmazon Corretto亚马逊提供的免费、多平台、生产就绪的 OpenJDK 发行版。libericaBellSoft Liberica JDK另一个流行的 OpenJDK 发行版。microsoftMicrosoft Build of OpenJDK。通过组合这两个参数可以精确控制项目所使用的 JDK 环境。3. 实践应用示例3.1 在 GitHub Actions 中配置在 GitHub Actions 的 workflow 文件中可以使用actions/setup-java动作来配置 JDK。jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkoutv4 - name: Set up JDK 17 (Temurin) uses: actions/setup-javav4 with: java-version: 17 distribution: temurin - name: Build with Maven run: mvn clean package3.2 在 Gradle 构建脚本中配置在 Gradle 的gradle-wrapper.properties或构建脚本中也可以指定工具链确保构建使用特定的 JDK。// build.gradle.kts java { toolchain { languageVersion.set(JavaLanguageVersion.of(17)) vendor.set(JvmVendorSpec.ADOPTIUM) // 对应 Temurin } }3.3 在 Dockerfile 中配置在构建 Docker 镜像时可以使用多阶段构建或直接从官方镜像获取指定版本和发行版的 JDK。# 使用 Eclipse Temurin 的 JDK 17 作为基础镜像 FROM eclipse-temurin:17-jdk-alpine AS builder WORKDIR /app COPY . . RUN ./gradlew build 运行时使用更小的 JRE 镜像 FROM eclipse-temurin:17-jre-alpine COPY --frombuilder /app/build/libs/*.jar app.jar ENTRYPOINT [java, -jar, /app.jar]4. 优势与最佳实践环境一致性确保从本地开发到 CI/CD 再到生产部署所有环节使用完全相同的 JDK 版本和发行版避免“在我机器上能运行”的问题。灵活切换项目需要升级或降级 JDK 版本时只需修改一个参数配置无需手动重装。可复现性将 JDK 配置作为代码的一部分使得任何环境都能快速、准确地复现出相同的构建环境。建议在项目根目录的配置文件如.github/workflows/ci.yml,gradle.properties中集中管理java-version和distribution参数。5. 总结通过java-version和distribution参数来管理 JDK 环境是一种高效、可靠且现代化的实践。它极大地简化了 Java 项目的环境配置工作提升了团队协作效率和软件交付质量。无论是个人项目还是企业级应用都建议采用这种方式来定义和锁定 JDK 依赖。