CLASSPATH 是 Java 虚拟机 用来查找类（.class 文件）和资源（如配置文件、图片等）的路径列表，它告诉 JVM：“去哪里找我需要的类？”

核心概念：什么是 CLASSPATH？

你可以把 CLASSPATH 想象成一个“寻宝图”的清单，JVM 在运行你的 Java 程序时，需要加载各种类，它会按照 CLASSPATH 中列出的路径顺序去寻找这些 .class 文件。

CLASSPATH 可以包含以下几种类型的路径：

• 目录路径：JVM 会在这个目录及其子目录下查找 .class 文件。
• JAR/ZIP 文件路径：JVM 会直接在这个压缩包中查找 .class 文件，这是最常见的情况，因为绝大多数第三方库（如 Spring, MySQL Connector/J）都是以 JAR 包形式提供的。
• *通配符 (`)**：在 Java 6 及以上版本中，可以表示匹配该目录下的所有 JAR 文件，例如lib/表示lib目录下的所有 JAR 包。**注意**：*` 不会递归匹配子目录中的 JAR 文件。

重要提示：在现代 Java 开发中（特别是从 Java 6 开始，并在 Java 9+ 的模块化系统中得到加强），显式地设置全局 CLASSPATH 变量已经越来越不推荐，更推荐的做法是使用构建工具（如 Maven, Gradle）来管理依赖，或者使用 java 命令的 -cp / -classpath 选项，理解 CLASSPATH 的工作原理对于排查问题和进行底层开发仍然至关重要。

如何配置 CLASSPATH

有三种主要的方式来设置 CLASSPATH，它们的优先级从高到低依次是：

1. 命令行选项（推荐，用于特定场景）
2. 当前目录（默认行为）
3. 环境变量（不推荐，容易引发冲突）

使用 -cp 或 -classpath 命令行选项（最常用、最推荐）

这是最灵活、最安全的方式，因为它只对当前运行的命令有效，不会影响其他 Java 程序。

语法：

java -cp <classpath> <主类名>

或者使用更完整的格式：

java -classpath <classpath> <主类名>

示例：

假设你的项目结构如下：

my_project/
├── src/
│   └── com/
│       └── example/
│           └── Main.java
├── lib/
│   ├── gson-2.8.9.jar
│   └── log4j-1.2.17.jar
└── out/
    └── production/
        └── my_project/
            └── com/
                └── example/
                    └── Main.class

1. 编译代码：

   # 从 src 目录编译，输出到 out 目录
   javac -d out src/com/example/Main.java

2. 运行程序：

   • 只包含当前编译输出目录：

     java -cp out com.example.Main

   • 包含编译输出目录和多个 JAR 包（在 Windows 中用 分隔，在 Linux/macOS 中用 分隔）：

     # Windows
     java -cp "out;lib\gson-2.8.9.jar;lib\log4j-1.2.17.jar" com.example.Main
     # Linux / macOS
     java -cp "out:lib/gson-2.8.9.jar:lib/log4j-1.2.17.jar" com.example.Main

   • *使用通配符 `` 简化 JAR 包路径**（Java 6+）：

     # Windows
     java -cp "out;lib/*" com.example.Main
     # Linux / macOS
     java -cp "out:lib/*" com.example.Main

     这个命令会自动将 out 目录和 lib 目录下所有的 JAR 文件都添加到类路径中。

默认的当前目录（）

如果你不设置任何 CLASSPATH，JVM 会自动将当前工作目录添加到类路径中，当前工作目录通常是你执行 java 命令时所在的目录。

示例：

# 假设你当前在 my_project 目录下
cd my_project
# Main.class 在 out/com/example/ 目录下
# 因为 out 目录在当前目录下，JVM 可以找到它
java com.example.Main

这里的 CLASSPATH 默认就包含了 （当前目录）。

设置 CLASSPATH 环境变量（不推荐）

这种方式会改变你整个操作系统的环境,可能导致其他 Java 程序因类路径冲突而失败。除非有特殊需求（如维护一个非常古老的系统），否则应尽量避免。

在 Windows 中设置：

1. 右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
2. 在“系统变量”区域，点击“新建”。
3. 变量名：CLASSPATH
4. 变量值：.;C:\path\to\your\libs\some.jar;C:\path\to\your\classes
   • 非常重要：开头的 表示包含当前目录，如果漏掉，JVM 将无法找到在当前目录下编译的类。
5. 点击确定保存。

在 Linux / macOS 中设置（临时生效）：

在终端中执行：

export CLASSPATH=".:~/path/to/your/libs/some.jar:/path/to/your/classes"

• 注意：这里的 也是代表当前目录，并且路径之间用 分隔。
• 这个设置只在当前终端会话中有效,要永久生效，需要将其添加到 ~/.bashrc 或 ~/.zshrc 等配置文件中。

CLASSPATH 查找顺序与优先级

当一个类被请求时,JVM 按以下顺序查找：

1. Bootstrap Classpath（启动类路径）：这是最高优先级，包含核心 Java 类库（如 rt.jar），这个路径通常由 JVM 自动设置，开发者一般不需要关心。
2. Extension Classpath（扩展类路径）：存放标准扩展库（JDK 8 及以前有效），现在也较少使用。
3. User Classpath（用户类路径）：这是开发者控制的路径，按以下顺序查找：
   • -cp / -classpath 命令行选项：如果设置了，则仅使用这个路径，忽略环境变量 CLASSPATH 和默认的当前目录。
   • CLASSPATH 环境变量：如果未使用 -cp 选项，则使用环境变量 CLASSPATH。
   • 当前目录（）：如果既没有 -cp 选项，也没有 CLASSPATH 环境变量，则使用当前目录。

总结一下优先级： -cp 选项 > CLASSPATH 环境变量 > 当前目录 ()

现代开发实践：为什么我们很少手动设置 CLASSPATH？

在 Maven, Gradle, Ant 等构建工具普及的今天，我们几乎不需要手动配置 CLASSPATH。

• Maven/Gradle：这些工具会自动管理项目的所有依赖（下载 JAR 包），并在编译和运行时自动构建正确的类路径，你只需要在 pom.xml (Maven) 或 build.gradle (Gradle) 文件中声明依赖即可。
• IDE (IntelliJ IDEA, Eclipse)：集成开发环境会根据你的项目配置自动管理类路径，你只需要添加依赖库，IDE 就会处理好一切。
• Java 9+ 模块系统 (JPMS)：Java 9 引入了模块，通过 module-info.java 文件来定义模块的依赖和导出，这是一种更强大、更明确的依赖管理方式，进一步减少了对传统的、扁平的 CLASSPATH 的依赖。

常见问题与排查

当遇到 ClassNotFoundException 或 NoClassDefFoundError 时，通常就是类路径配置问题。

1. ClassNotFoundException：JVM 在运行时找不到指定的类，通常是因为类路径中没有包含该 .class 文件所在的目录或 JAR 包。

   • 排查：检查你的 -cp 或 CLASSPATH 路径是否正确，是否包含了编译后的 .class 文件所在的目录。

2. NoClassDefFoundError：JVM 找到了这个类的定义文件（.class），但在加载这个类时发生了错误（这个类依赖的其他类找不到，或者静态初始化块出错）。

   • 排查：这不仅仅是类路径问题，首先检查类路径，然后检查该类的依赖是否也都在类路径中，并查看程序日志是否有更详细的错误信息。

排查小技巧：使用 -verbose:class 选项启动 JVM，它会打印出每个被加载的类的详细信息，包括从哪个路径加载的，这能帮你快速定位问题。

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

希望这份详细的指南能帮助你彻底理解 Java 的 CLASSPATH 配置！