跳转至

如何在命令行中运行 Java 项目

简介

在命令行（CMD）中运行 Java 项目是 Java 开发中一项基础且重要的技能。相较于集成开发环境（IDE），在命令行中运行项目能让开发者更深入地理解 Java 项目的编译和运行机制，同时也便于在没有 IDE 或者需要自动化脚本处理的场景下使用。本文将详细介绍在命令行中运行 Java 项目的基础概念、使用方法、常见实践以及最佳实践。

目录

  1. 基础概念
  2. 使用方法
  3. 常见实践
  4. 最佳实践
  5. 小结
  6. 参考资料

基础概念

Java 源文件与字节码文件

  • Java 源文件：以 .java 为扩展名，包含 Java 代码。它是开发者编写的可读代码文件。
  • 字节码文件：以 .class 为扩展名，是 Java 源文件经过编译后生成的文件。字节码文件可以在任何安装了 Java 虚拟机（JVM）的系统上运行。

Java 编译器（javac）

javac 是 Java 编译器，用于将 Java 源文件编译成字节码文件。例如，要编译一个名为 HelloWorld.java 的源文件，可以使用以下命令：

javac HelloWorld.java

Java 虚拟机（java）

java 命令用于启动 Java 虚拟机并运行编译后的字节码文件。例如，要运行 HelloWorld.class 文件，可以使用以下命令：

java HelloWorld

类路径（Classpath）

类路径是 Java 虚拟机用于查找类文件的路径。在命令行中，可以使用 -cp 或 -classpath 选项指定类路径。例如：

java -cp .:lib/mylib.jar HelloWorld

上述命令中，.:lib/mylib.jar 表示当前目录（.）和 lib 目录下的 mylib.jar 文件都在类路径中。

使用方法

简单 Java 程序的运行

假设我们有一个简单的 Java 程序 HelloWorld.java：

// HelloWorld.java
public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, World!");
    }
}
  1. 编译源文件：打开命令行，进入 HelloWorld.java 文件所在的目录，然后执行以下命令：
javac HelloWorld.java

这将在当前目录下生成 HelloWorld.class 文件。

  1. 运行字节码文件：执行以下命令：
java HelloWorld

输出结果应该是：

Hello, World!

包含多个类的 Java 项目的运行

假设我们有一个包含多个类的 Java 项目，结构如下：

project/
├── src/
│   ├── Main.java
│   └── Helper.java

Main.java 代码如下：

// Main.java
import com.example.Helper;

public class Main {
    public static void main(String[] args) {
        Helper helper = new Helper();
        helper.printMessage();
    }
}

Helper.java 代码如下：

// Helper.java
package com.example;

public class Helper {
    public void printMessage() {
        System.out.println("This is a helper message.");
    }
}
  1. 编译源文件：进入 src 目录，执行以下命令：
javac -d ../bin Main.java Helper.java

-d 选项指定编译后的类文件输出目录，这里指定为 ../bin。

  1. 运行字节码文件：进入 bin 目录，执行以下命令：
java -cp . com.example.Main

输出结果应该是：

This is a helper message.

包含外部依赖的 Java 项目的运行

假设我们的 Java 项目依赖于 gson-2.8.8.jar 文件，项目结构如下：

project/
├── src/
│   └── Main.java
├── lib/
│   └── gson-2.8.8.jar

Main.java 代码如下：

// Main.java
import com.google.gson.Gson;

public class Main {
    public static void main(String[] args) {
        Gson gson = new Gson();
        String json = gson.toJson("Hello, Gson!");
        System.out.println(json);
    }
}
  1. 编译源文件：进入 src 目录，执行以下命令：
javac -cp ../lib/gson-2.8.8.jar -d ../bin Main.java
  1. 运行字节码文件：进入 bin 目录，执行以下命令：
java -cp .:../lib/gson-2.8.8.jar com.example.Main

输出结果应该是：

"Hello, Gson!"

常见实践

脚本化运行

可以编写脚本文件来简化编译和运行过程。例如，在 Windows 系统上，可以创建一个 run.bat 文件：

@echo off
javac -cp lib/gson-2.8.8.jar -d bin src/*.java
java -cp bin:lib/gson-2.8.8.jar com.example.Main

在 Linux 或 macOS 系统上，可以创建一个 run.sh 文件：

#!/bin/bash
javac -cp lib/gson-2.8.8.jar -d bin src/*.java
java -cp bin:lib/gson-2.8.8.jar com.example.Main

然后在命令行中执行相应的脚本文件即可。

错误处理

在命令行中运行 Java 项目时，可能会遇到各种错误。例如，编译错误或运行时异常。可以通过查看命令行输出的错误信息来定位问题。如果编译时出现错误，错误信息会指出具体的错误位置和原因；如果运行时出现异常，异常堆栈信息会显示异常的类型和发生位置。

最佳实践

管理类路径

使用 MANIFEST.MF 文件来管理类路径。在创建 JAR 文件时，可以在 MANIFEST.MF 文件中指定类路径，这样在运行 JAR 文件时就不需要手动指定类路径了。例如，创建一个 MANIFEST.MF 文件：

Manifest-Version: 1.0
Main-Class: com.example.Main
Class-Path: lib/gson-2.8.8.jar

然后使用以下命令创建 JAR 文件：

jar cfm myproject.jar MANIFEST.MF -C bin .

最后运行 JAR 文件：

java -jar myproject.jar

版本控制

在项目中使用版本控制系统（如 Git）来管理代码。这样可以方便地跟踪代码的变更，同时也便于团队协作。

小结

在命令行中运行 Java 项目需要掌握 Java 编译器（javac）和 Java 虚拟机（java）的使用方法，以及类路径的概念。通过本文的介绍，你应该已经了解了如何在命令行中编译和运行简单的 Java 程序、包含多个类的 Java 项目以及包含外部依赖的 Java 项目。同时，你也学习了一些常见实践和最佳实践，希望这些知识能帮助你更高效地在命令行中运行 Java 项目。

参考资料