java classpath

Java classpath 是 Java 运行时和编译工具用来查找类文件与资源文件的路径集合，和 Java 程序的启动、编译以及依赖加载直接相关。简单说，它告诉 Java“去哪里找我要用的类”，找错了或漏了，程序就可能报错。

基本含义与用途

classpath 可以理解为一份“查找目录清单”。当 Java 需要加载某个类时，会按 classpath 中列出的目录、JAR 包或 ZIP 包依次查找。编译时用 `-classpath` 或 `-cp` 指定依赖位置，运行时同样用它告诉 JVM 去哪里找类。常见形式包括目录（如 `classes/`）、JAR 文件（如 `lib/foo.jar`）以及通配符（如 `lib/*`）。如果不指定，默认使用当前目录。

常见问题

最典型的问题是 `ClassNotFoundException` 或 `NoClassDefFoundError`，通常是因为某个 JAR 没被加入 classpath，或者路径写错、相对路径基准不对。另一个常见坑是 classpath 顺序：同名类出现在多个位置时，先找到的会被使用，可能导致版本不一致。还有通配符只匹配 JAR 而不递归子目录、路径分隔符在 Windows 与 Linux 下不同等细节，也容易让人踩坑。

怎么判断或怎么选

排查时先看报错缺的是哪个类，再确认对应的 JAR 是否在 classpath 中，路径是否真实存在。可以用 `java -verbose:class` 观察类加载来源，或写一个简单程序打印 `System.getProperty("java.class.path")` 查看实际生效的 classpath。选择上，小型项目手动用 `-cp` 即可；依赖较多时建议用 Maven、Gradle 等构建工具管理，或使用 `-classpath` 配合 `lib/*` 简化书写。关键是保持依赖来源清晰、顺序可控，避免把无关目录塞进 classpath。