必须下载JDK而非JRE,选择匹配系统的x64版本(推荐Eclipse Temurin),安装时勾选“Add to PATH”,配置JAVA_HOME指向JDK根目录,并在Path中添加%JAVA_HOME%\bin;验证java -version和javac -version一致,IDE、Maven等工具依赖JAVA_HOME正确设置。

下载并安装JDK,别选错版本
Windows 用户最常踩的坑是下了 JRE 而不是 JDK,或者装了 x86 版本却在 64 位系统上跑 IDE。必须确认下载的是 JDK(含 javac 编译器),且架构匹配系统(一般选 x64)。Oracle 官网已限制直接下载旧版 JDK,推荐用 Adoptium Eclipse Temurin(免费、开源、更新及时)。
安装时勾选「Add to PATH」——如果没勾,后续得手动把 bin 目录加进系统环境变量,路径类似:C:\Program Files\Eclipse Adoptium\jdk-17.0.1+12-hotspot\bin
验证是否成功:
java -version javac -version
两个命令都应输出版本号,且版本一致。若只认 java 不认 javac,说明装的是 JRE 或 PATH 没配对。
立即学习“Java免费学习笔记(深入)”;
配置 JAVA_HOME 环境变量,IDE 和构建工具依赖它
很多工具(如 Maven、Gradle、IntelliJ、Eclipse)默认通过 JAVA_HOME 找 JDK,而不是靠 PATH 里的 java.exe。不配或配错会导致编译失败、Maven 报 Unsupported class file major version 等错误。
操作步骤(Windows 10/11):
- 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
- 在「系统变量」里点「新建」,变量名填
JAVA_HOME,变量值填 JDK 的根目录(不是bin子目录!),例如:C:\Program Files\Eclipse Adoptium\jdk-17.0.1+12-hotspot - 确保
Path中包含%JAVA_HOME%\bin(如果安装时没勾选自动添加,就手动加)
配完重启终端或命令提示符,再执行 echo %JAVA_HOME% 看是否输出正确路径。
选择并配置 IDE:IntelliJ IDEA 社区版足够用
不用强求 Eclipse 或 NetBeans;IntelliJ IDEA Community 版完全免费,对 Java SE 支持极好,且开箱即用程度高。安装后首次启动会提示配置 SDK:
- 新建项目 → 左侧选
Java→ 右侧「Project SDK」点New... → JDK - 浏览到
JAVA_HOME所指目录,选中即可(IDE 会自动识别rt.jar和javac) - 如果提示「No JDK specified」或「Invalid JDK path」,大概率是选到了
bin目录,或路径含中文/空格(建议 JDK 安装到纯英文无空格路径,如C:\dev\jdk-17)
顺便检查 Project language level 和 SDK 设置是否一致,比如 JDK 17 对应 language level 17,否则可能遇到 var 关键字报错或 switch 表达式不识别。
Maven 或 Gradle 选一个,别跳过构建工具
手写 javac + java 命令能跑 Hello World,但真实开发离不开依赖管理与生命周期控制。Windows 下推荐用 SDKMAN!(需 WSL)或直接下载二进制包解压配置。
以 Maven 为例(最新稳定版 3.9.x):
- 下载
apache-maven-3.9.7-bin.zip,解压到无空格路径,如C:\dev\maven - 新增系统变量
M2_HOME=C:\dev\maven,并在Path中追加%M2_HOME%\bin - 验证:
mvn -v应显示 Maven 版本、Java 版本、JDK 路径 —— 这里会再次校验JAVA_HOME是否生效
创建第一个 Maven 项目时,IDE 通常自动识别 pom.xml;如果手动运行,注意 Windows 下路径分隔符是反斜杠,但 Maven 内部统一处理,不用特别转义。
Gradle 更轻量,适合快速脚本类项目,但国内用户要注意 gradle init 默认连境外仓库,可提前在 %USERPROFILE%\.gradle\init.gradle 里配阿里云镜像。
真正卡住人的往往不是某个步骤不会做,而是多个环节的环境变量互相干扰:比如系统 PATH 里残留旧 JDK 的 bin,JAVA_HOME 指向另一个版本,IDE 又单独设置了 Project SDK——三者不一致时,java -version、javac -version、IDE 控制台输出、Maven 编译结果可能全都不一样。










