1. 什么是 Classpath
Classpath 是 Java 运行时和编译时用于定位类文件、JAR 包和资源文件的路径集合。JVM 通过 Classpath 找到程序依赖的类，从而完成加载、链接和初始化。简单来说，Classpath 告诉 JVM「去哪里找代码」。
当使用 java 或 javac 命令时，如果没有显式指定 Classpath，JVM 会使用当前目录作为默认 Classpath。理解 Classpath 的机制，是排查 ClassNotFoundException 和 NoClassDefFoundError 等常见异常的基础。
2. Classpath 的组成与优先级
Classpath 可以由多个路径组成，路径之间使用分隔符隔开：
- Windows ：使用分号
;分隔。 - Linux / macOS ：使用冒号
:分隔。
Classpath 中的每一项可以是：
- 目录路径，JVM 会递归查找其中的
.class文件。 - JAR 包路径，JVM 会读取包内的类。
- ZIP 包路径，与 JAR 类似。
- 通配符
*，匹配指定目录下的所有 JAR 包。
JVM 按照 Classpath 中路径的先后顺序查找类，找到第一个匹配的类后即停止。因此，路径顺序会影响最终加载的类版本，这也是「类冲突」问题的根源之一。
3. 设置 Classpath 的常见方式
设置 Classpath 主要有以下几种方式，按优先级从高到低排列：
- 命令行参数 ：使用
-cp或-classpath指定，优先级最高。 - 环境变量 ：设置
CLASSPATH环境变量。 - 默认值 ：未设置时，JVM 使用当前目录
.。
推荐优先使用命令行参数，避免环境变量带来的全局影响。下面给出一个典型示例：
bash
java -cp lib/*:classes com.example.Main该命令将 lib 目录下的所有 JAR 包和 classes 目录加入 Classpath，并运行 com.example.Main 主类。
4. 编译与运行时的 Classpath
编译期和运行期的 Classpath 需要分别关注：
- 编译期 ：
javac需要找到被引用的类，使用-cp指定依赖。 - 运行期 ：
java需要找到所有运行时依赖的类，包括主类和第三方库。
一个常见错误是编译通过但运行失败，原因往往是运行期 Classpath 缺少了某个依赖 JAR。建议在编译和运行时使用一致的 Classpath 配置，避免环境差异。
5. 常见问题与排查思路
以下是 Classpath 相关的常见异常及排查方向：
| 异常 | 可能原因 | 排查方向 |
|---|---|---|
| ClassNotFoundException | 类不在 Classpath 中 | 检查 -cp 是否包含对应 JAR 或目录 |
| NoClassDefFoundError | 编译期存在但运行期缺失 | 检查运行期依赖是否完整 |
| NoSuchMethodError | 依赖版本冲突 | 检查 Classpath 中是否存在多个版本 JAR |
排查时可以使用 java -verbose:class 查看 JVM 实际加载了哪些类，快速定位类来源。
6. 总结
Classpath 是 Java 开发中绕不开的基础概念。掌握它的组成、设置方式和排查方法，可以有效避免类加载相关的坑。建议在实际项目中优先使用构建工具（如 Maven 或 Gradle）管理依赖，减少手动维护 Classpath 的成本。