Java运行HelloWorld教程详解

Java初学者运行第一个HelloWorld程序看似简单，实则处处是坑：核心只在于两件事——严格保证源文件名与public类名完全一致（大小写敏感），以及正确配置JDK环境变量并确保javac和java命令全局可用；任何编译失败、类找不到或乱码问题，几乎都源于文件命名不规范、PATH未包含JDK的bin目录、编译运行路径错误，或混淆了包结构与文件系统路径。掌握这两大关键点，就能绕过90%的入门障碍，稳稳迈出Java编程的第一步。

Java程序能跑起来，核心就两步：写对源文件、用对命令。其他所有问题——报错、找不到类、乱码——基本都卡在这两个环节。

确保 javac 和 java 命令可用

不是装了JDK就自动能用，得确认它们在系统 PATH 里：

• 终端执行 javac -version 和 java -version，必须都输出版本号（比如 17.0.1）
• 如果提示 command not found，说明环境变量没配好；Windows 用户重点检查 JAVA_HOME 是否指向 JDK 根目录，且 %JAVA_HOME%\bin 已加入 PATH
• 别用 JRE 目录下的 bin ——它只有 java，没有 javac，编译直接失败

HelloWorld.java 文件名和类名必须严格一致

Java 要求 public 类的名称与文件名完全相同（包括大小写），且一个 .java 文件里最多一个 public 类：

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, World!");
    }
}

• 文件必须叫 HelloWorld.java，不能是 helloworld.java 或 HelloWorld.JAVA
• 类名 HelloWorld 首字母大写，main 方法签名不能写成 main(String args[])（虽语法允许，但非常规，易被 IDE 或教学环境拒绝）
• 如果类不是 public（比如 class HelloWorld），文件名仍需是 HelloWorld.java，但此时不能加 public 修饰符

编译和运行必须在正确路径下执行

当前工作目录决定 javac 找源码的位置，也影响 java 加载类时的默认 classpath：

• 假设 HelloWorld.java 在 /home/user/demo/ 下，先 cd /home/user/demo，再运行 javac HelloWorld.java
• 生成的 HelloWorld.class 会出现在同一目录；运行时必须仍在该目录下，执行 java HelloWorld（注意：不带 .class 后缀）
• 如果执行 java ./HelloWorld 或 java demo.HelloWorld，会报 Could not find or load main class —— Java 把点号当成包分隔符，不是路径分隔符
• 有包声明（如 package demo;）时，文件必须放在对应子目录（demo/HelloWorld.java），编译和运行命令也要进到上层目录操作

最容易忽略的是大小写敏感和当前路径——Linux/macOS 下 helloworld.java 和 HelloWorld.java 是两个文件；Windows 虽不区分，但 java 命令内部仍按大小写匹配类名，错一个字母就找不见主类。

到这里，我们也就讲完了《Java运行HelloWorld教程详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！