如何使用命令行编译运行Java程序？一篇讲透
一、为什么需要学会用命令行编译运行Java？
很多Java初学者一开始接触的都是集成开发环境（IDE），比如Eclipse、IntelliJ IDEA、NetBeans等。这些工具确实很方便，点一下按钮就能编译运行，还能自动提示错误。但是，如果只依赖IDE，很容易忽略Java程序从源代码到可执行文件的完整过程。实际上，Java程序的运行分为两步：编译和解释执行。编译阶段由javac命令将.java源文件转换成.class字节码文件；解释执行阶段由java命令启动Java虚拟机（JVM），读取字节码并逐条翻译成机器码执行。
学会用命令行操作，至少有三个好处：第一，能让你真正理解Java的跨平台原理——字节码文件可以在任何安装了JVM的系统上运行；第二，在服务器环境（比如Linux）中，通常没有图形界面，你必须通过命令行部署和运行Java程序；第三，面试时经常会被问到编译和执行的过程，亲手操作过印象更深。所以，不管你是不是新手，掌握命令行编译运行Java都是一项基本功。
二、前置准备：配置Java环境变量
在使用命令行之前，首先要确保你的电脑上安装了Java开发工具包（JDK），并且配置好了环境变量。这一步非常重要，因为命令行在执行java和javac时，需要知道去哪里找这些可执行文件。
2.1 下载并安装JDK
前往Oracle官网或OpenJDK镜像站，下载与你操作系统匹配的JDK安装包。目前主流的版本是JDK 8、11、17和21，建议选择长期支持版本（LTS），比如JDK 17。安装过程很简单，一路下一步即可。安装完成后，记住安装路径，例如在Windows系统下默认路径是C:\Program Files\Java\jdk-17，在macOS下可能是/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home。
2.2 配置JAVA_HOME和Path变量
环境变量的作用是让操作系统知道JDK的位置。具体操作如下：
- Windows系统：右键点击“此电脑” → “属性” → “高级系统设置” → “环境变量”。在“系统变量”区域点击“新建”，变量名填
JAVA_HOME，变量值填JDK的安装路径（例如C:\Program Files\Java\jdk-17）。然后在系统变量中找到Path，双击编辑，点击“新建”，添加%JAVA_HOME%\bin。注意，%JAVA_HOME%会自动替换成刚才设置的路径。最后点击确定保存。 - macOS/Linux系统：打开终端，编辑shell配置文件（如
~/.bash_profile或~/.zshrc），添加以下两行：保存后执行source ~/.bash_profile使配置生效。
2.3 验证配置是否成功
打开一个新的命令行窗口（Windows下按Win+R，输入cmd；macOS下打开终端），依次输入以下两条命令：
java -version
javac -version如果屏幕上输出了Java和javac的版本信息，说明环境变量配置成功了。如果提示“不是内部或外部命令”或“command not found”，请检查JAVA_HOME路径是否正确，以及Path变量是否包含了bin目录。有时候需要重启命令行窗口才能生效。
三、编写第一个Java源程序
在开始编译之前，我们需要先写一个Java源文件。Java源文件是以.java为后缀的纯文本文件，里面包含Java代码。这里有一个非常重要的规则：源文件名必须和文件中定义的公开类名完全一致，包括大小写。这是因为Java编译器在编译时会根据文件名查找对应的类定义。
例如，我们要写一个经典的HelloWorld程序。在本地任意位置创建一个文件夹，比如D:\java_demo（Windows）或~/java_demo（macOS/Linux）。在该文件夹内新建一个文本文件，命名为HelloWorld.java。注意，Windows系统默认可能隐藏了文件扩展名，你需要确保文件的全名是HelloWorld.java，而不是HelloWorld.java.txt。
用记事本或任何文本编辑器打开该文件，输入以下内容：
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello, Java Command Line!");
}
}这段代码定义了一个公开类HelloWorld，里面有一个main方法，它是程序的入口。System.out.println用于在控制台输出一行文字。保存文件后，我们就有了一个可以编译的源程序。
四、使用命令行编译Java程序
编译Java程序使用的是javac命令，它的全称是Java Compiler。javac会将.java源文件编译成.class字节码文件，这个过程会检查语法错误，如果代码有误则会报错。
4.1 切换到源文件所在目录
打开命令行窗口，使用cd命令切换到HelloWorld.java所在的目录。例如：
cd D:\java_demo在macOS/Linux下：
cd ~/java_demo4.2 执行编译命令
输入以下命令并按回车：
javac HelloWorld.java如果代码没有任何语法错误，命令行不会输出任何信息，只会静默地完成编译。此时，你可以在当前目录下看到一个新生成的HelloWorld.class文件。这个文件就是字节码文件，它包含了可以被Java虚拟机执行的指令。
如果代码中有错误，比如漏掉了分号、拼写错了关键字，javac会输出详细的错误信息，指出错误发生在第几行以及错误类型。例如：
HelloWorld.java:3: error: ';' expected
System.out.println("Hello")
^
1 error根据提示修改源文件，然后重新执行javac命令，直到编译成功为止。
4.3 理解字节码文件
生成的.class文件是二进制格式，不能用文本编辑器直接查看（打开会看到乱码）。但它是一种中间代码，不依赖于具体的操作系统和硬件。正因为如此，Java才能实现“一次编译，到处运行”——你只需要在目标平台上安装对应版本的JVM，就能直接运行这个.class文件。
五、使用命令行运行Java程序
编译成功后，我们就可以运行程序了。运行使用的是java命令，它负责启动JVM并加载字节码文件。
5.1 运行不带包名的程序
在命令行中，确保当前目录仍然是HelloWorld.class所在的目录，然后输入：
java HelloWorld注意：千万不要加.class后缀！如果写成java HelloWorld.class，JVM会认为你要运行的类名是HelloWorld.class，从而报错“找不到或无法加载主类”。正确的写法就是类名本身。
执行后，你会看到控制台输出：
Hello, Java Command Line!至此，第一个Java程序就成功运行了。
5.2 为什么运行时不加后缀？
因为java命令的参数是要运行的类的完全限定名（fully qualified class name），而不是文件名。对于没有包名的类，类名就是HelloWorld。JVM会根据类名去查找对应的.class文件。如果你加了.class，它会把整个字符串当作类名，自然找不到。
六、带包名的Java程序编译运行
实际项目中的Java代码几乎都会使用包（package）来组织类，以避免命名冲突。包名通常采用公司域名的倒序，比如com.ippipp.demo。带包名的程序在编译和运行时有一些额外的注意事项。
6.1 编写带包名的源文件
在D:\java_demo目录下，创建一个子目录结构com\demo（注意：Windows下反斜杠，Linux/macOS下正斜杠）。在com/demo目录下新建一个Test.java文件，内容如下：
package com.demo;
public class Test {
public static void main(String[] args) {
System.out.println("This is a program with package.");
}
}第一行package com.demo;声明了这个类属于com.demo包。保存后，文件路径必须是D:\java_demo\com\demo\Test.java，也就是说，目录结构必须与包名一一对应。
6.2 编译带包名的源文件
编译时，需要切换到包结构的根目录（即D:\java_demo），然后指定源文件的相对路径：
cd D:\java_demo
javac com\demo\Test.java编译成功后，会在com/demo目录下生成Test.class文件。
6.3 运行带包名的程序
运行带包名的类时，必须使用完整的包名加类名，并且要在根目录下执行：
java com.demo.Test注意分隔符是点号（.），而不是斜杠。执行后会输出：
This is a program with package.6.4 常见误区
很多人会犯的一个错误是：在运行带包名的程序时，先cd到了com/demo目录下，然后执行java Test，结果报错“找不到或无法加载主类”。这是因为JVM会在当前目录及其子目录中寻找类，但当你进入com/demo后，JVM期望类名是Test，但字节码文件中的类实际是com.demo.Test，包名缺失导致无法匹配。正确的做法是始终在包结构的根目录下运行，并使用完整包名。
七、常见问题及解决方法
7.1 “javac”不是内部或外部命令
这几乎是新手遇到最多的问题。原因是JDK的环境变量没有配置正确。请按照前面第二章的步骤仔细检查JAVA_HOME和Path。另外，配置完成后一定要打开新的命令行窗口，因为旧的窗口不会自动加载新的环境变量。
7.2 编译时提示“找不到文件”
这种情况通常是因为当前命令行所在的目录与源文件所在的目录不一致。使用cd命令切换到源文件所在的目录，或者使用绝对路径编译，例如：
javac D:\java_demo\HelloWorld.java另外，检查文件名是否完全正确，包括大小写。在Windows下文件名不区分大小写，但在Linux/macOS下严格区分。
7.3 运行时提示“找不到或无法加载主类”
可能有以下几种原因：
- 运行命令中加了
.class后缀。去掉后缀即可。 - 当前目录不是
.class文件所在的根目录。对于带包名的程序，必须在包结构的根目录下运行。 - 类名拼写错误，包括大小写。Java是大小写敏感的语言。
.class文件损坏或不存在。重新编译一次。
7.4 编译成功但运行时报错“NoClassDefFoundError”
这个错误通常意味着JVM找到了主类，但找不到它所依赖的其他类。比如主类引用了另一个类，而那个类的.class文件不在类路径（classpath）中。解决方法是使用-cp参数指定类路径，例如：
java -cp . com.demo.Test这里的.表示当前目录，也可以换成其他路径。
八、总结
通过命令行编译运行Java程序，本质上就是掌握两个核心命令：javac用于编译，java用于运行。但背后涉及的细节不少，比如环境变量配置、文件名与类名一致、包名与目录结构对应、运行时不加后缀等。这些细节恰恰是理解Java运行机制的关键。
建议初学者亲自动手操作几次，从最简单的HelloWorld开始，再到带包名的程序，逐步加深理解。当你习惯了命令行操作后，你会发现它对排错和深入理解JVM非常有帮助。以后即使切换到IDE，也能清楚知道IDE在背后替你做了什么。