classpath 是 Java 运行时环境 查找用户自定义类（.class 文件）和资源文件（如 .properties, .xml, 图片等）的路径列表，你可以把它想象成一个“寻宝地图”，JVM 会按照这个地图上的路径去寻找你程序中需要用到的类。
为什么需要 Classpath？
当你编写 Java 代码并编译后，会生成一堆 .class 文件,这些文件可能分布在不同的目录中。
my-app/
├── src/
│ ├── com/
│ │ └── example/
│ │ └── Main.java
│ └── resources/
│ └── config.properties
└── bin/
└── com/
└── example/
└── Main.class当你的 Main.class 文件需要加载 config.properties 时，JVM 怎么知道去哪里找这个 properties 文件？这就是 classpath 的作用，你需要告诉 JVM：“请去 bin 目录下找 .class 文件，去 resources 目录下找资源文件”。
Classpath 的组成
classpath 通常由以下几个部分组成：
- 当前目录 ()：默认情况下，JVM 会包含当前工作目录（即运行
java命令所在的目录）。 - 环境变量
CLASSPATH：操作系统级别的环境变量，在较新的 Java 开发中，这种方式已不推荐，因为它会覆盖默认行为,容易引起混乱。 - 命令行参数
-classpath或-cp：这是最常用、最推荐的方式，在运行java命令时明确指定，只对当前命令有效,不会影响其他程序。 - JAR/ZIP 文件：
classpath不仅可以指向目录，也可以直接指向一个 JAR 或 ZIP 包，JVM 会自动在这些归档文件中查找类和资源。 - Java 模块路径 (Module Path, Java 9+)：在 Java 9 引入模块系统后，
classpath和模块路径是分开的，模块路径用于存储模块化的 JAR 文件。
如何设置和查看 Classpath？
1 命令行方式 (-cp 或 -classpath)
这是最灵活和最常用的方式。
语法：
java -cp "路径1;路径2;路径3" 主类名
或者：
java -classpath "路径1;路径2;路径3" 主类名
关键点：
- 路径分隔符：
- Windows: 使用分号
- Linux / macOS: 使用冒号
- 主类名: 是你想要运行的类的全限定名，
com.example.Main。
示例：
假设我们有以下目录结构：
project/
├── bin/ # 存放 .class 文件
├── lib/ # 存放第三方 JAR 包
│ └── gson-2.8.9.jar
└── src/ # 存放 .java 源文件-
只包含
bin目录：# 在 project 目录下运行 java -cp bin com.example.Main
-
包含
bin目录和一个 JAR 包：# 在 project 目录下运行 java -cp "bin;lib/gson-2.8.9.jar" com.example.Main
-
包含多个目录和 JAR 包：
# 假设还有一个 tools 目录存放工具类 java -cp "bin;lib/gson-2.8.9.jar;tools" com.example.Main
2 查看当前 Classpath
在运行 Java 程序时，可以通过以下方式查看 JVM 实际使用的 classpath：
-
使用
-verbose:class参数：这个参数会打印出 JVM 加载的每一个类的详细信息，包括从哪个路径加载的，信息量很大,但非常精确。java -verbose:class -cp "bin;lib/gson-2.8.9.jar" com.example.Main
-
在代码中打印：你可以通过
System.getProperty("java.class.path")来获取当前 classpath 的字符串。public class PrintClasspath { public static void main(String[] args) { String classpath = System.getProperty("java.class.path"); System.out.println("Current Classpath is:"); System.out.println(classpath); } }运行
java -cp "bin;lib/gson-2.8.9.jar" PrintClasspath，它会打印出bin;lib/gson-2.8.9.jar。
Classpath 与构建工具 (Maven/Gradle)
在现代 Java 开发中，我们几乎不会手动去设置 classpath，这项工作由构建工具（如 Maven 或 Gradle）自动完成。
-
Maven：当你运行
mvn package时，Maven 会将你的代码编译到target/classes目录，并将所有依赖的 JAR 包下载到target/lib目录，它会创建一个可执行的 JAR 文件（my-app-1.0.jar），这个 JAR 文件的MANIFEST.MF文件中会自动设置好Main-Class和Class-Path属性，你只需要运行java -jar my-app-1.0.jar即可。 -
Gradle：原理类似，Gradle 会将编译后的类放在
build/classes/java/main，依赖的库放在build/libs，同样，它会生成一个可执行的 JAR，你只需运行java -jar build/libs/my-app-1.0.jar。
这些工具通过读取 pom.xml (Maven) 或 build.gradle (Gradle) 文件，自动解析项目依赖，并最终为你生成一个正确配置好 classpath 的可执行文件。
常见问题
1 ClassNotFoundException
原因：JVM 在 classpath 中找不到指定的类。
解决方案：
- 检查类名是否正确（包括包名）。
- 检查
.class文件是否存在于classpath指定的路径中。 - 检查
classpath的路径是否写错了，特别是路径分隔符（ vs ）。 - 如果使用了第三方库，确保其 JAR 文件已正确添加到
classpath中。
2 NoClassDefFoundError
原因：.class 文件找到了，但在加载这个类时，它所依赖的其他类没有被找到，这说明 classpath 不完整，缺少了某个依赖。
示例：你的 Main.class 依赖于 com.example.utils.Helper.class，但 Helper.class 不在 classpath 中，此时会报 NoClassDefFoundError。
解决方案：检查并确保所有相关的依赖（.class 文件或 JAR 包）都已添加到 classpath。
| 特性 | 说明 |
|---|---|
| 定义 | JVM 查找 .class 文件和资源的路径列表。 |
| 重要性 | Java 程序能够正确运行的基础。 |
| 设置方式 | 推荐：使用命令行 -cp 或 -cp 参数。不推荐：设置系统环境变量 CLASSPATH。 |
| 路径分隔符 | Windows: |
| 现代实践 | 使用 Maven, Gradle 等构建工具自动管理，无需手动配置。 |
| 常见错误 | ClassNotFoundException (路径错误), NoClassDefFoundError (依赖缺失)。 |
理解 classpath 是掌握 Java 运行机制的关键一步,尤其是在调试和部署应用程序时。
