classpath（类路径）是 Java 虚拟机 用来查找类（.class 文件）和资源文件（如 .properties, .xml 等）的路径列表，它就是 JVM 的“寻宝图”，告诉它去哪里寻找你程序中依赖的其他类。

为什么需要 Classpath？

当你编写 Java 代码时，会用到 Java 核心库（如 java.lang.String）、第三方库（如 mysql-connector-java.jar）以及你自己项目中的其他类。

JVM 在运行时，需要知道这些类的 .class 文件存放的位置。classpath 就是用来指定这些位置的，JVM 在 classpath 指定的所有路径中都找不到所需的类，它就会抛出著名的 ClassNotFoundException。

Classpath 的核心概念

classpath 是一个路径列表，在 Windows 系统中，路径之间用分号分隔；在 Linux 或 macOS 系统中，路径之间用冒号分隔。

这个列表可以包含以下几种类型的路径：

1. 目录路径：指定一个目录，JVM 会从这个目录开始，递归地查找 .class 文件。
2. JAR/ZIP 文件路径：指定一个 JAR 或 ZIP 文件，JVM 会从这个文件的根目录中查找 .class 文件，这是最常用的方式，因为它能将所有相关的类打包成一个文件。
3. *通配符 (`)**：从 Java 6 开始，classpath支持通配符。会匹配当前目录下所有的 JAR 文件。lib/表示lib` 目录下的所有 JAR 文件。

   注意： 不会匹配子目录中的 JAR 文件，也不会匹配目录本身，它只匹配扩展名为 .jar 或 .JAR 的文件。

Classpath 的配置方式（从旧到新）

随着 Java 的发展，配置 classpath 的方式也变得越来越方便，下面我们按历史顺序介绍。

通过环境变量 CLASSPATH

这是最古老的方式,通过设置操作系统环境变量来定义全局的类路径。

• Windows:
  1. 在“系统属性” -> “高级” -> “环境变量”中。
  2. 在“系统变量”部分，新建或编辑 CLASSPATH 变量。
  3. 值可以设置为：.;C:\path\to\my\libs\mylib.jar，注意开头的 ，它代表当前目录。
• Linux/macOS:

  export CLASSPATH=.:$CLASSPATH:/path/to/my/libs/mylib.jar

  同样代表当前目录，$CLASSPATH 表示追加到原有的类路径后面。

缺点：

• 全局生效,可能影响其他 Java 程序。
• 对于单个项目来说,配置不灵活。
• 现在已不推荐使用。

通过 java 命令的 -cp 或 -classpath 选项

这是最常用、最灵活的方式，可以在运行 Java 程序时临时指定类路径，而不会影响环境变量。

语法：

java -cp <classpath> <主类全限定名>

示例：

假设你的项目结构如下：

my_project/
├── src/
│   └── com/
│       └── example/
│           └── Main.java
├── lib/
│   └── gson-2.10.1.jar
└── out/
    └── com/
        └── example/
            └── Main.class

1. 编译：将 src 目录下的所有 .java 文件编译到 out 目录。

   javac -d out src/com/example/Main.java

   注意：Main.java 引用了 gson.jar，编译时也需要指定 classpath，否则会报错。

2. 运行：

   • 情况A：只包含当前目录 Main.class 在当前目录下（比如你在 my_project 目录下运行），并且它只依赖 Java 核心库。

     java -cp . com.example.Main

     • -cp . 表示类路径是当前目录。com.example.Main 是要执行的主类。

   • 情况B：包含目录和 JAR 文件 Main.class 在 out 目录下，并且依赖 lib/gson-2.10.1.jar。

     java -cp "out;lib/gson-2.10.1.jar" com.example.Main

     • 在 Windows 上，路径用 分隔。
     • 在 Linux/macOS 上，路径用 分隔：

       java -cp "out:lib/gson-2.10.1.jar" com.example.Main

   • *情况C：使用通配符 `** 如果lib目录下有多个 JAR 文件，使用*` 非常方便。

     java -cp "out;lib/*" com.example.Main

     这会自动把 lib 目录下所有的 JAR 文件都加入到类路径中。

通过清单文件 (MANIFEST.MF) 的 Class-Path 属性

当你的项目被打包成一个可执行的 JAR 文件时，你可以在 JAR 文件的清单文件中指定依赖的其他 JAR 文件。

1. 创建 META-INF/MANIFEST.MF 文件，内容如下：

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

   • Main-Class: 指定程序入口。
   • Class-Path: 指定依赖的 JAR 文件，这里的路径是相对于当前 JAR 文件所在目录的，多个 JAR 之间用空格分隔。

2. 打包你的项目：

   jar cvfm my_app.jar META-INF/MANIFEST.MF -C out .

   • f: 指定 JAR 文件名。
   • m: 指定清单文件。
   • -C out .: 从 out 目录下将所有文件打包进 JAR。

3. 运行：

   java -jar my_app.jar

   • 注意：当使用 -jar 选项时，JVM 会忽略 -cp 或 -classpath 以及环境变量 CLASSPATH 的设置，它会完全使用 JAR 文件 MANIFEST.MF 中指定的 Class-Path。

模块路径（Java 9+）

从 Java 9 开始，Java 引入了模块系统，带来了新的类路径管理方式：模块路径。

• 类路径：用于传统的、非模块化的代码。
• 模块路径：用于模块化的代码（带有 module-info.java 的项目）。

使用 --module-path (或 -p) 来指定模块路径。

# 运行一个模块化的应用
java --module-path mods -m com.myapp/com.myapp.Main

• --module-path mods: 指定模块所在的 mods 目录。
• -m com.myapp/com.myapp.Main: -m 指定要运行的模块和主类。

模块路径 vs 类路径：

• 类路径 是一个“平面”的查找结构，所有类都在一个大的命名空间下，容易导致“JAR 地狱”（Jar Hell）。
• 模块路径 是一个“有向图”结构，模块之间有明确的依赖关系，封装了内部实现，提高了可靠性和可维护性。

对于新项目,特别是大型项目，强烈推荐使用模块系统。

现代 Java 项目的最佳实践：构建工具

在实际开发中,几乎没有人会手动去配置 classpath，我们使用构建工具（如 Maven 或 Gradle）来管理依赖和构建流程。

这些工具会自动：

1. 从中央仓库下载你项目所需的所有第三方库（JAR 文件）。
2. 编译你的源代码。
3. 将所有依赖和你的代码打包成一个可分发的 JAR 文件（通常是“胖 JAR”或“uber JAR”），这个 JAR 文件包含了所有运行时需要的类。

以 Maven 为例： 你只需要在 pom.xml 文件中声明依赖：

<dependencies>
    <dependency>
        <groupId>com.google.code.gson</groupId>
        <artifactId>gson</artifactId>
        <version>2.10.1</version>
    </dependency>
</dependencies>

然后运行 mvn package，Maven 就会处理好一切，生成一个可以直接用 java -jar 运行的 JAR 文件。

核心建议：

• 日常学习和简单测试：使用 java -cp 命令，它能让你最直观地理解 classpath 的工作原理。
• 实际项目开发：使用 Maven 或 Gradle，不要手动管理 JAR 文件和 classpath，让构建工具为你处理。
• 新的大型项目：考虑迁移到 Java 9+ 的模块系统，享受它带来的好处。