Java命令行运行失败主因是环境配置错误，需依次检查JDK安装、JAVA_HOME与PATH设置、java/javac版本一致性；编译时须确保public类名与文件名严格一致；运行时注意classpath路径及中文/空格路径的引号处理。
Java命令行运行失败的常见报错及定位方法
运行 java HelloWorld 报错 “command not found” 或 “无法找到或加载主类”，通常不是代码问题，而是环境没配对。先确认两件事：JDK是否已安装、JAVA_HOME 和 PATH 是否生效。
- 在终端执行
which java（macOS/Linux）或where java（Windows），无输出说明PATH没包含 JDK 的bin目录 - 执行
echo $JAVA_HOME（macOS/Linux）或echo %JAVA_HOME%（Windows），为空则变量未设置 - 执行
java -version和javac -version，版本不一致（如 java 17 / javac 11）会导致编译后运行失败
javac 编译时必须注意的路径与命名规则
javac 不是“认文件名”，而是“认 public class 名”。哪怕你把源文件命名为 MyApp.java，只要里面声明了 public class HelloWorld，就必须用 javac HelloWorld.java 编译，且文件必须和类名严格一致（大小写敏感）。
- 源文件中不能有多个
public class；否则编译报错：class XXX is public, should be declared in a file named XXX.java - 如果类不是
public，文件名可任意，但运行时仍需用java ClassName（不含.class后缀），且当前目录下必须存在ClassName.class - 编译生成的
.class文件默认放在当前目录；若用javac -d out/ HelloWorld.java，则字节码会输出到out/HelloWorld.class，此时运行需加-cp out：
javac -d out/ HelloWorld.java java -cp out HelloWorld
java 命令运行时 classpath 的隐式行为
很多人以为 java HelloWorld 就是“直接找当前目录下的 HelloWorld.class”，其实它默认使用 -cp .（当前目录为 classpath 根），但这个“当前目录”指的是 运行时所在路径，不是源文件或 class 文件所在路径。
Windows 命令行编码与兼容规范。涵盖 GBK/UTF-8 编码、PowerShell/pwsh 互操作、Python/Node.js、Git 配置及代码生成规则。适用于 Windows 10/11 + MSYS2/Git Bash 环境下的所有命令行操作。
- 如果
HelloWorld.class在./bin/HelloWorld.class，而你在项目根目录执行java HelloWorld，会报错Could not find or load main class HelloWorld - 正确做法：进入
bin目录再运行，或指定 classpath：java -cp bin HelloWorld - classpath 中多个路径用
:（macOS/Linux）或;（Windows）分隔，例如：java -cp lib/spring.jar:bin MyApp
Windows 下中文路径或空格导致 java 找不到类的解决方式
当 JDK 安装在 C:\Program Files\Java\jdk-17，或项目路径含中文（如 D:\我的Java练习\），java 命令可能因路径解析异常而失败——这不是编码问题，是 shell 对空格和特殊字符的转义缺失。
立即学习“Java免费学习笔记（深入）”；
- 临时规避：将 JDK 安装到无空格路径，如
C:\jdk17\；项目也避免中文和空格 - 必须用中文路径时，启动命令需用双引号包裹 classpath：
java -cp "D:\我的Java练习\bin" HelloWorld - 检查
JAVA_HOME是否带引号（Windows 系统变量里不要加引号），否则%JAVA_HOME%\bin拼接后会出错
最易被忽略的一点：IDE 自动生成的 module-info.java 会让 javac 默认启用模块系统，此时即使简单程序也会因缺少 --module-path 而运行失败。初学建议删掉该文件，或用 javac --release 8 HelloWorld.java 强制降级兼容性。
