Java入门：环境搭建全攻略

积累知识，胜过积蓄金银！毕竟在文章开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《Java学习第一步：环境搭建详解》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

环境搭建是首次接触Java运行机制的实操门槛，需正确配置JAVA_HOME指向JDK根目录、PATH包含其bin路径，并确保javac与java版本一致，否则将导致编译或运行失败。

环境搭建不是“第一步”，而是你第一次真正面对 Java 运行机制的实操门槛——没配好 javac 和 java，连最简单的 System.out.println("Hello") 都会报 Error: Could not find or load main class 或 command not found。

为什么 JAVA_HOME 必须指向 JDK 而不是 JRE

JDK 包含编译器 javac、调试器 jdb、打包工具 jar 等；JRE 只有运行时环境。IDE（如 IntelliJ）或构建工具（如 Maven）在调用 javac 时，会优先读取 JAVA_HOME。若指向 JRE，mvn compile 直接失败，报错 The JAVA_HOME environment variable is not defined correctly。

• JAVA_HOME 应设为 JDK 安装根目录（如 /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home 或 C:\Program Files\Java\jdk-21）
• Windows 下检查：echo %JAVA_HOME%；macOS/Linux 下：echo $JAVA_HOME
• PATH 中应包含 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（macOS/Linux），否则终端找不到 javac

javac 编译成功但 java 执行失败的常见原因

这是初学者最常卡住的环节：明明写了 Hello.java，javac Hello.java 没报错，可 java Hello 却提示 Could not find or load main class Hello。

• 当前目录下没有生成 Hello.class 文件（检查是否误删、是否在错误目录执行了 javac）
• 类名与文件名不一致（public class Hello 必须保存为 Hello.java，大小写敏感）
• 执行 java 时加了 .class 后缀（错：java Hello.class；对：java Hello）
• 当前目录不在 CLASSPATH 中（默认 . 在 classpath，但若手动设置了 CLASSPATH 环境变量且没包含 .，就会找不到）

IDE 自带 JDK 和系统 JDK 不一致导致的诡异问题

IntelliJ 默认使用 Bundled JDK（如 JetBrains Runtime），而终端命令行用的是系统配置的 JAVA_HOME。这会导致：在 IDE 里能跑的代码，终端里 java -version 显示 JDK 17，但 javac -version 显示 JDK 21，编译出的字节码版本不兼容。

• 检查一致性：终端运行 java -version 和 javac -version，二者主版本号必须相同（如都是 17 或都是 21）
• IntelliJ 中需同步：File → Project Structure → Project → Project SDK → 选和终端一致的 JDK
• Maven 项目还需确认 pom.xml 中 maven-compiler-plugin 的 source 和 target 与 JDK 版本匹配（JDK 21 对应 21，不是 1.21）

环境问题从来不是“配完就完”的一步，而是贯穿整个学习过程的隐性依赖。每次换机器、升级 JDK、切项目分支，都可能触发新的路径或版本冲突。最稳妥的做法是：每次新开终端，先跑一遍 javac -version && java -version && echo $JAVA_HOME —— 看三者是否自洽，比反复猜错因高效得多。

今天关于《Java入门：环境搭建全攻略》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！