统一JDK版本关键在于全流程管控：一选LTS版本并明确交付物，二用PowerShell或SDKMAN标准化安装与环境变量，三在Maven/Gradle/CI中强制绑定JDK，四将IDE配置固化进项目文件并写入SETUP.md。
团队开发统一 JDK 版本，关键不在“怎么装”，而在于“怎么管”——装只是第一步，确保所有人用同一版本、配置一致、不因本地环境差异导致构建失败或运行异常，才是核心目标。下面分四步说清楚，直击团队落地痛点。
一、选定版本并明确交付物
不要让每个成员自己去官网找 JDK。团队应共同约定一个经验证的 LTS 版本（如 JDK 17.0.9 或 JDK 21.0.4），并统一来源（推荐 Eclipse Temurin 或 Amazon Corretto，免费、稳定、有长期支持）。交付物包括：
- 官方下载链接（带校验码 SHA256）
- 标准安装路径建议（如
C:\java\jdk-17或/opt/java/jdk-17） - 配套的
java -version和javac -version预期输出样例
二、标准化安装与环境变量配置
避免“我这能跑，你那报错”。推荐两种方式，按团队技术栈选其一：
- Windows 团队：提供一键 PowerShell 脚本（含静默安装 + JAVA_HOME/PATH 自动写入），要求管理员权限运行；禁用安装向导中“自动添加到 PATH”选项，由脚本统一控制顺序
-
macOS/Linux 团队：使用
SDKMAN!统一安装（sdk install java 17.0.9-tem），再通过sdk default java 17.0.9-tem设为全局默认；所有成员执行同一命令，路径自动归一到~/.sdkman/candidates/java/current
无论哪种方式，都必须验证：echo $JAVA_HOME 输出路径一致，且 which java 指向该 JDK 的 bin 目录。
立即学习“Java免费学习笔记（深入）”；
三、构建工具强制绑定 JDK 版本
光靠系统环境变量不可靠——CI 流水线、IDE、Maven/Gradle 各自可能读取不同 JDK。必须在项目层锁定：
-
Maven：在
pom.xml中声明<maven.compiler.source>17</maven.compiler.source>和<maven.compiler.target>17</maven.compiler.target> -
Gradle：在
gradle.properties中设org.gradle.java.home=/opt/java/jdk-17（Linux/macOS）或对应 Windows 路径 -
CI 配置（如 GitHub Actions）：显式指定
actions/setup-java@v4并设置java-version: '17'，避免依赖 runner 默认 JDK
四、IDE 配置纳入项目规范
IntelliJ 或 VSCode 若没配对 JDK，照样会编译报红。不能靠口头提醒，要固化进项目文件：
-
IntelliJ：提交
.idea/misc.xml（启用<project-jdk-name value="17 (Temurin)" />）和.idea/modules.xml，确保新克隆项目开箱即用 -
VSCode：在项目根目录下提交
.vscode/settings.json，包含"java.home": "/opt/java/jdk-17"和"java.jdt.ls.java.home": "/opt/java/jdk-17" - 补充说明文档
SETUP.md，写明 IDE 配置截图+验证步骤（如 “打开任意 .java 文件，Ctrl+Click String 应跳转到 JDK 17 的源码”）
不复杂但容易忽略。统一 JDK 不是装一次就完事，而是把版本选择、安装路径、环境变量、构建配置、IDE 设置全部纳入团队可复现、可验证、可审计的流程里。
