运行java -version输出版本号即配置成功；否则检查java_home路径是否指向jdk根目录、path是否包含%java_home%\bin（windows）或$java_home/bin（macos/linux），并确认终端已重启或执行source刷新配置。
怎么确认 Java 环境变量配置成功了
打开终端（Windows 用 cmd 或 powershell，macOS/Linux 用 terminal），直接运行：
java -version
如果输出类似 java version "17.0.1" 或更高版本号，说明 JAVA_HOME 和 PATH 都设对了；如果报错 'java' is not recognized as an internal or external command（Windows）或 command not found: java（macOS/Linux），说明 PATH 没生效，或 JAVA_HOME 路径写错了。
-
JAVA_HOME必须指向 JDK 安装根目录（如C:\Program Files\Java\jdk-17.0.1或/Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home），不能指向bin子目录 - Windows 下修改完环境变量要重启终端；macOS/Linux 如果是改的
~/.zshrc或~/.bash_profile，记得运行source ~/.zshrc - 别把
java.exe所在路径（如%JAVA_HOME%\bin）漏加进PATH
用 javac 编译 .java 文件时常见错误
写好一个 Hello.java 后，在文件所在目录执行 javac Hello.java。失败通常有三类原因：
- 报错
error: class files not found：当前目录没在源码路径里，或用了-d指定输出目录但没配-cp，检查是否误删了.java后缀、文件名大小写是否和public class名完全一致 - 报错
cannot find symbol：依赖的类没编译，或没加到 classpath，比如引用了MyUtils.java，得先javac MyUtils.java再编译主类 - 中文乱码（如“非法字符：'\u6709'）：源文件编码不是 UTF-8，用
javac -encoding UTF-8 Hello.java显式指定
成功后会在同目录生成 Hello.class —— 注意不是 .java，这是字节码，可跨平台运行。
立即学习“Java免费学习笔记（深入）”；
运行 java 命令时为什么总提示 “找不到或无法加载主类”
这是最常卡住的地方。运行 java Hello（注意：不带 .class 后缀）失败，核心原因是 JVM 找不到类的二进制定义。关键点：
- 必须在
Hello.class所在目录下运行java，且类名大小写严格匹配（java hello≠java Hello） - 如果类在包里（如
package cn.demo;），则Hello.class必须放在cn/demo/子目录中，然后从cn的父目录运行java cn.demo.Hello - classpath 默认是当前目录（
.），如果手动设了-cp却忘了包含当前目录，就会找不到，例如java -cp lib/mylib.jar Hello会忽略当前目录，应写成java -cp ".;lib/mylib.jar" Hello（Windows）或java -cp ".:lib/mylib.jar" Hello（macOS/Linux）
javac 和 java 的路径处理逻辑完全不同
很多人以为 javac 和 java 对路径的理解是一致的，其实相反：
-
javac是按文件系统路径找.java源文件，它不关心包声明，只看当前目录 +-sourcepath -
java是按 classpath + 包名结构找.class，它严格解析package，并把点号（.）转成路径分隔符 - 所以
javac demo/Hello.java成功，不代表java demo.Hello就能运行——你得确保demo/Hello.class在 classpath 根目录下，而不是在demo目录里执行java
真正容易被忽略的是：哪怕只写一个类，只要用了 package，就必须按目录结构组织文件，且运行时要用全限定类名。这点和 Python 或 JavaScript 的执行逻辑差异很大，新手极易在这里反复碰壁。
