classpath 是 Java 开发中最基础也最容易被误解的概念之一。许多人将其视为一个模糊的“路径集合”，但它的本质其实非常具体——它就是 JVM 用来查找 .class 文件的一张“寻宝地图”。这张地图上的每一个坐标，都是你硬盘上真实存在的文件夹或 JAR 包文件。

---

一、classpath 的实体本质

classpath 并非虚拟概念。在实体层面，它就是一个由以下两种元素组成的字符串列表：

1. 文件系统目录路径：存放 .class 文件的文件夹。
2. JAR 包文件路径：包含 .class 文件的压缩包（.jar 文件）。

JVM 的类加载器（ClassLoader）会严格按照这个列表中的顺序，依次去这些具体位置里查找所需的 .class 文件。无论是你自己的代码，还是第三方库的代码，都逃不开这张地图的指引。

---

二、classpath 在三大常见场景下的实体表现

场景1：命令行直接运行 Java 程序

这是理解 classpath 最纯粹的方式。当你不使用任何构建工具或 IDE，直接用 java 命令时，classpath 就是你通过 -cp（或 -classpath）参数显式传入的那个字符串。

实体示例：

假设你的项目文件系统结构如下：

/my-project
  ├── my-classes/          # 存放你自己编译的 .class 文件
  │   └── com/xxx/MyMain.class
  └── my-libs/             # 存放依赖的 JAR 包
      └── spring-web.jar

你在终端中运行程序：

# Linux/macOS 使用冒号 `:` 分隔路径
java -cp /my-project/my-classes:/my-project/my-libs/spring-web.jar com.xxx.MyMain

# Windows 使用分号 `;` 分隔路径
java -cp C:\my-project\my-classes;C:\my-project\my-libs\spring-web.jar com.xxx.MyMain

这里的 /my-project/my-classes:/my-project/my-libs/spring-web.jar 就是 classpath 在实体层面的最直接体现。JVM 拿到这个字符串后，会精确地去这两个位置寻找 .class 文件。

---

场景2：Maven 项目中的 classpath（自动化管理）

Maven 极大地简化了 classpath 的管理，但它在底层做的事情与命令行完全一致——自动收集所有必要的路径，并拼接成一个字符串传递给 JVM。

我们可以从两个角度来观察其“实体性”：

(1) 文件系统实体：classpath 路径在哪里？

Maven 项目的 classpath 主要由两部分构成，它们都是你硬盘上真实存在的路径：

• 源代码编译输出目录：

  • 路径：<项目根目录>/target/classes
  • 说明：你手写的 .java 文件经过 mvn compile 编译后，生成的 .class 文件会按包结构存放在这个目录下。例如，com.xxx.MyClass 对应的文件路径就是 target/classes/com/xxx/MyClass.class。

• 依赖的 JAR 包路径：

  • 路径：你的 Maven 本地仓库（默认为 ~/.m2/repository (Linux/macOS) 或 C:\Users\<用户名>\.m2\repository (Windows)）。
  • 说明：所有通过 <dependency> 声明的第三方库，都会被下载并存储在这里。例如，spring-web 的 JAR 包路径可能是 ~/.m2/repository/org/springframework/spring-web/5.3.20/spring-web-5.3.20.jar。

(2) Maven 如何传递 classpath 给 JVM？

当你执行 mvn test 或 mvn spring-boot:run 等命令时，Maven 会在后台完成以下工作：

1. 自动扫描并收集上述两类路径。
2. 将它们拼接成一个完整的、以操作系统分隔符（: 或 ;）连接的字符串。
3. 通过相应的插件（如 maven-surefire-plugin 用于测试，spring-boot-maven-plugin 用于运行）将此字符串作为 -cp 参数传递给新启动的 JVM 进程。

验证方法： 你可以通过运行 mvn dependency:build-classpath 命令，让 Maven 直接打印出它为你构建的完整 classpath 字符串，里面全是你的本地文件系统路径。