在Java开发中，将程序打包成JAR文件是一种常见的部署方式，而通过命令行运行JAR文件则是最基础也是最核心的操作之一，本文将详细讲解如何使用Java命令行运行JAR文件，包括环境准备、基本命令、参数配置、常见问题处理以及高级技巧等内容,帮助开发者全面掌握这一技能。
确保你的系统已经安装了Java开发工具包（JDK），在命令行中输入java -version命令，如果显示Java版本信息，则说明环境已配置正确；否则需要先下载并安装JDK，并设置好JAVA_HOME环境变量以及Path变量中的%JAVA_HOME%\bin（Windows系统）或$JAVA_HOME/bin（Linux/macOS系统），这是运行Java程序的前提条件,也是后续所有操作的基础。
当JAR文件准备就绪后，最简单的运行方式是在命令行中进入JAR文件所在的目录，然后执行java -jar jar文件名.jar命令，如果你的JAR文件名为app.jar，则输入java -jar app.jar并按回车键，系统会加载JAR文件中的主类并执行其main方法，这种命令方式的核心在于-jar参数，它告诉Java虚拟机（JVM）从指定的JAR文件中读取主类信息并启动程序，需要注意的是，JAR文件必须具备正确的清单（Manifest）文件，其中通过Main-Class属性指定了程序的入口类,否则JVM将无法找到主类而导致运行失败。
除了基本的-jar参数外，JVM还支持丰富的参数配置，这些参数通常以开头，用于调整内存分配、垃圾回收策略、日志级别等运行时行为。-Xms和-Xmx分别用于设置JVM的初始堆内存大小和最大堆内存大小，单位为兆字节（MB），如java -jar -Xms512m -Xmx1024m app.jar表示设置初始堆内存为512MB，最大堆内存为1024MB。-D参数用于设置系统属性，例如-Dfile.encoding=UTF-8可以指定文件的编码格式为UTF-8，避免因编码不一致导致的乱码问题，对于需要调试的场景，还可以添加-verbose参数来输出JVM的详细运行信息，如类加载过程、内存使用情况等。
当JAR文件依赖其他外部库时，直接运行可能会因为类路径（Classpath）缺失而抛出ClassNotFoundException异常，针对这种情况，有几种解决方案：一是将所有依赖的JAR文件打包到当前JAR文件中，通过在构建工具（如Maven或Gradle）中配置shade或assembly插件实现；二是使用-cp或-classpath参数手动指定依赖JAR文件的路径，例如java -cp "lib/*.jar" -jar app.jar，其中lib/*.jar表示lib目录下所有JAR文件；三是从Java 6开始，JAR文件支持在清单文件中通过Class-Path属性指定依赖路径，例如Class-Path: lib/lib1.jar lib/lib2.jar,这种方式需要注意路径是相对于JAR文件位置的相对路径。
对于需要长时间运行的服务端程序，还可以结合nohup（Linux/macOS系统）或start命令（Windows系统）来实现后台运行，在Linux系统中，可以使用nohup java -jar app.jar > app.log 2>&1 &命令，其中nohup表示忽略挂断信号，>将标准输出重定向到app.log文件，2>&1表示将错误输出也重定向到标准输出，&表示让命令在后台执行，这种方式特别适合部署在服务器上的Java应用,可以避免因终端关闭而导致程序终止。
在运行过程中，可能会遇到各种问题，如果程序启动时提示“无法访问jarfile”，通常是因为JAR文件路径错误或文件不存在，此时需要检查命令中的路径是否正确，可以使用绝对路径来避免相对路径的混淆，如果提示“主类未找到”，则需要检查JAR文件的清单文件中的Main-Class属性是否正确配置，或者是否在打包时遗漏了必要的类文件，对于内存溢出（OutOfMemoryError）问题，可以通过调整-Xmx参数增大堆内存，或者使用-XX:+HeapDumpOnOutOfMemoryError参数在内存溢出时生成堆转储文件,以便后续分析内存泄漏的原因。
为了更直观地展示常用JVM参数及其作用,以下是一个简单的表格：
| 参数 | 作用 | 示例 |
|---|---|---|
| -Xms | 设置初始堆内存大小 | -Xms256m |
| -Xmx | 设置最大堆内存大小 | -Xmx1024m |
| -Dfile.encoding | 设置文件编码格式 | -Dfile.encoding=UTF-8 |
| -verbose:class | 输出类加载信息 | -verbose:class |
| -XX:+HeapDumpOnOutOfMemoryError | 内存溢出时生成堆转储文件 | -XX:+HeapDumpOnOutOfMemoryError |
除了上述基本操作外，还可以结合Java的其他工具进行更高级的调试和管理，使用jps命令可以查看当前系统中运行的Java进程及其进程ID（PID），使用jstat命令可以监控JVM的内存使用、垃圾回收等运行时数据，使用jstack命令可以生成Java线程的转储快照，用于分析线程死锁等问题，这些工具对于排查线上问题非常有帮助,开发者需要熟练掌握它们的使用方法。
通过命令行运行JAR文件是Java开发中必须掌握的基本技能，从简单的java -jar命令到复杂的JVM参数配置，再到依赖管理和问题排查，每一个环节都需要开发者深入理解其背后的原理，只有在实践中不断积累经验，才能在面对各种复杂场景时游刃有余，确保Java程序能够稳定、高效地运行。
相关问答FAQs：
-
问：运行JAR文件时提示“主类未找到”，是什么原因？如何解决？
答：通常是因为JAR文件的清单文件（META-INF/MANIFEST.MF）中未正确配置Main-Class属性，或者Main-Class指定的类在打包时未包含在JAR文件中，解决方法是：首先检查清单文件中的Main-Class属性是否正确，确保类名包含完整的包路径（如com.example.Main）；检查构建工具的配置，确保所有必要的类文件都被打包到JAR中；如果依赖了外部JAR文件，还需确保类路径配置正确,避免依赖缺失导致类加载失败。 -
问：如何在Windows系统中将Java JAR程序设置为后台服务，使其开机自启？
答：在Windows系统中，可以使用NSSM（Non-Sucking Service Manager）工具将JAR程序安装为Windows服务，首先下载NSSM并解压，然后在命令行中进入NSSM目录，执行nssm install 服务名 "java路径" -jar "JAR文件路径"命令，例如nssm install MyApp "C:\Program Files\Java\jdk-11\bin\java.exe" -jar "C:\app\app.jar"，安装完成后，可以通过services.msc管理工具找到该服务，并设置其启动类型为“自动”，即可实现开机自启，NSSM会自动处理进程管理，即使程序崩溃也会自动重启,确保服务的稳定性。
