classpath 是 jvm 运行时动态查找类和资源的路径集合，决定 java 命令加载类的位置，按启动类路径、扩展类路径、应用类路径优先级合并；正确设置方式包括命令行 -cp、manifest.mf 中 class-path 声明、环境变量 classpath（不推荐）；现代项目由 maven/gradle 或 ide 自动管理，spring boot 则通过自定义类加载器重载规则；排查问题可用 -verbose:class 或 java -cp xxx.jar yourmainclass 查看实际 classpath。
classpath 是 Java 运行时定位类（.class 文件）和资源的路径集合，不是“配置一次就一劳永逸”的静态设置，而是由 JVM 启动时依据规则动态解析的查找范围。 它不决定编译过程（javac 用 -cp 或 -classpath 指定依赖），而决定运行时（java 命令）去哪里加载类——找不到类会直接抛出 NoClassDefFoundError 或 ClassNotFoundException。
classpath 的三种主要来源
Java 查找类时按以下优先级顺序合并所有有效 classpath 路径：
-
启动类路径（Bootstrap Classpath）：JVM 自带的核心类库（如
rt.jar、resources.jar），由-Xbootclasspath控制，普通应用极少修改； -
扩展类路径（Extension Classpath）：
$JAVA_HOME/jre/lib/ext下的 JAR（已从 Java 9 起废弃，模块系统替代）； - 应用类路径（Application Classpath）：开发者真正需要配置的部分，即常说的 “classpath”，包含自定义类、第三方 JAR、配置文件等。
如何正确设置应用 classpath
有且仅有三种标准方式，推荐按场景选用：
-
命令行显式指定（最清晰）：
java -cp "lib/spring-core.jar:lib/commons-lang3.jar:classes:config/" MyApp
注意：Windows 用分号;，Linux/macOS 用冒号:；路径支持目录（自动扫描 .class）、JAR 文件（自动解压读取 META-INF/MANIFEST.MF 中的 Class-Path）； -
JAR 包内 MANIFEST.MF 声明（适合可执行 JAR）：
在META-INF/MANIFEST.MF中写入：Class-Path: lib/gson.jar lib/logback.jar config/
路径是相对于该 JAR 所在目录的相对路径，空格分隔，每行最多 72 字符（续行用空格开头）； -
环境变量 CLASSPATH（不推荐）：
设置CLASSPATH=.:lib/*（注意.表示当前目录）；
缺点明显：全局生效、易被覆盖、IDE 和构建工具通常忽略它，仅适合极简脚本场景。
现代项目中 classpath 实际由构建工具管理
手动拼接 classpath 在 Maven/Gradle 项目中几乎不存在，但理解其机制仍关键：
立即学习“Java免费学习笔记（深入）”；
- Maven 编译时将
src/main/java编译到target/classes，资源复制到同目录；测试类放在target/test-classes； - Maven Surefire 插件运行测试时，自动把
target/classes、target/test-classes和所有dependencies的 JAR 加入 classpath； - IDE（IntelliJ/Eclipse）将 module output path 和 libraries 自动注册为 classpath，无需手动配置 —— 但导出为 JAR 或部署时，必须显式打包或声明依赖路径；
- Spring Boot 的
fat jar把依赖嵌套进BOOT-INF/lib/，并使用自定义LaunchedURLClassLoader解析，此时传统 classpath 规则被重载。
排查 classpath 问题的实用技巧
当遇到类找不到或版本冲突，快速验证：
- 运行时加
-verbose:class参数，查看 JVM 实际加载了哪些类、从哪个 JAR 或路径加载； - 用
java -cp xxx.jar YourMainClass -cp（注意：-cp 后跟类名，不是参数）可打印当前 classpath 内容（JDK 8+ 支持）； - 检查 JAR 包是否损坏：
jar -tf xxx.jar | head -20；确认 MANIFEST.MF 中 Class-Path 是否拼写正确、路径是否存在； - 区分
ClassNotFoundException（加载阶段没找到类）和NoClassDefFoundError（编译期存在、运行期因静态初始化失败等导致类不可用）。
