标准文档要求jdk安装与环境变量配置必须清晰、可复现、无歧义：需确认系统架构、卸载冲突版本、选用lts版；安装时禁用附加组件、路径不含空格中文；仅设java_home和path（前置添加），禁用classpath；验证须全部通过。
标准文档的核心是清晰、可复现、无歧义。JDK安装与环境变量配置不是“点下一步就行”的流程，而是涉及路径规范、变量职责、工具链依赖的系统性操作。下面按企业级标准文档结构组织，去掉冗余解释，保留关键动作和必须说明的细节。
一、安装前确认事项
确保满足以下前提，否则后续配置必然失败：
- 操作系统架构匹配：Windows 查“系统属性”确认是64位；macOS 点“关于本机”看芯片类型（Intel选x64，M系列选arm64）
- 卸载冲突版本：运行java -version和javac -version，若输出版本不一致（如java是17，javac报错），说明存在JRE单独安装或旧JDK残留，需通过控制面板或终端彻底卸载
- 选择LTS版本：当前推荐JDK 21（支持至2026年9月）或JDK 17；避免使用非LTS版本（如JDK 22/23），因Spring Boot等主流框架尚未全面适配
二、JDK安装规范
安装方式分两类，均需明确指定路径：
- 图形化安装（.exe/.dmg）：取消勾选“Public JRE”“Java Update”等附加组件；安装路径不含空格和中文，推荐D:\jdk-21（Windows）或/Library/Java/JavaVirtualMachines/jdk-21.jdk（macOS）
- 压缩包解压（.zip/.tar.gz）：解压到无权限限制目录（如Windows非C:\Program Files，macOS非/System）；解压后验证bin目录下存在javac、java可执行文件
三、环境变量配置标准
仅需配置两项，顺序和写法不可颠倒：
- JAVA_HOME：新建系统变量，值为JDK根目录（D:\jdk-21或/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home），不带\bin
- PATH：编辑现有PATH变量，在最前面添加%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（macOS/Linux）；禁止硬编码完整路径
注意：CLASSPATH已过时，现代构建工具（Maven/Gradle）和IDE自动管理类路径，无需手动设置。
四、验证与交付检查
在全新命令行窗口中逐条执行，全部通过才算配置完成：
- echo %JAVA_HOME%（Windows）或echo $JAVA_HOME（macOS/Linux）→ 输出应与安装路径完全一致
- java -version → 显示JDK 21.x.x等LTS版本号
- javac -version → 输出与java -version相同，证明编译器可用
- where java（Windows）或which java（macOS/Linux）→ 路径应指向%JAVA_HOME%\bin\java或$JAVA_HOME/bin/java
若任一检查失败，退回第三步核对变量值和PATH插入位置；不要尝试“多加几个路径”来蒙混过关。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
