Java环境搭建指南：Windows版详细教程

本文手把手教你避开Windows下Java开发环境搭建的几乎所有坑：从必须下载JDK（而非JRE）并选择匹配系统的x64版本（强烈推荐免费开源的Eclipse Temurin），到正确配置JAVA_HOME和PATH环境变量、验证javac与java版本一致，再到IDE（如IntelliJ IDEA）的SDK识别技巧、Maven/Gradle构建工具的安装与镜像优化，最后点破多版本共存时环境变量冲突这一“隐形杀手”——帮你一次配对、全程避雷，让Hello World真正跑起来，而不是卡在编译失败或版本不兼容的报错里。

下载并安装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_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 编译结果可能全都不一样。

理论要掌握，实操不能落！以上关于《Java环境搭建指南：Windows版详细教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！