Java类路径（Classpath）是JVM运行时查找.class文件和JAR/ZIP包的路径配置，不参与编译，错误配置导致ClassNotFoundException等异常；支持命令行（最高优先级）、CLASSPATH环境变量、MANIFEST中Class-Path三种方式；不包含.java源文件或配置资源。
Java 类路径（Classpath）是 JVM 查找和加载类文件（.class）的关键机制。它不决定源码如何编译，而专管运行时“去哪里找已编译的类”。配置错误会导致 ClassNotFoundException 或 NoClassDefFoundError —— 这些异常几乎都源于类路径没对上，而非代码写错了。
类路径到底管哪些资源
Classpath 指定的是 JVM 启动时搜索以下内容的目录或归档路径：
- 编译后的
.class文件（含顶层类与嵌套类） -
.jar和.zip包（JVM 把它们当“类仓库”读取） - 模块路径（
--module-path）是 Java 9+ 引入的独立机制，与传统 classpath 并行但不混用；若用了模块系统，JVM 默认忽略 classpath 中的自动模块（除非显式加--add-modules） - 注意：它不包含 .java 源文件、配置文件（如
application.properties）、静态资源（如 HTML/JS）——这些需靠应用逻辑或框架（如 Spring 的ClassLoader.getResource()）另行定位
三种主要配置方式及优先级
类路径可通过命令行、环境变量或构建工具设置，三者有明确优先级：命令行参数 > 当前环境变量 CLASSPATH > JVM 默认值（当前目录 .）。
-
命令行指定（最推荐）：
java -cp "lib/a.jar:lib/b.jar:classes/" MyApp（Linux/macOS）或java -cp "lib\a.jar;lib\b.jar;classes\" MyApp（Windows，用分号） -
环境变量 CLASSPATH：全局生效，容易引发冲突。例如设为
CLASSPATH=.:lib/commons-lang3.jar，所有java命令都会默认带上它 —— 很难追踪，不建议用于多项目环境 -
Manifest 文件中 Class-Path 属性：在
jar的META-INF/MANIFEST.MF里写Class-Path: lib/gson.jar lib/log4j-api.jar，仅对该 jar 启动时生效（注意：路径是相对于该 jar 所在目录的，不是绝对路径）
常见陷阱与验证方法
很多问题看似随机，实则源于 classpath 的隐式行为：
立即学习“Java免费学习笔记（深入）”；
-
空格和引号要小心：路径含空格时必须整体加英文双引号，如
-cp "libs/my utils.jar:classes/"；只给部分加引号（如-cp libs/"my utils.jar"）会失败 -
重复类导致“静默覆盖”：若 classpath 中两个 jar 都含
com.example.Utils.class，JVM 加载第一个找到的，后面那个完全被忽略 —— 不报错，但行为可能异常 -
验证是否生效？：启动时加
-verbose:class参数，JVM 会打印每个加载的类及其来源路径，例如：[Loaded java.lang.Object from /jdk/jre/lib/rt.jar]或[Loaded com.MyApp from file:/home/app/classes/] -
IDE 不等于真实环境：IntelliJ/Eclipse 自动组装 classpath 并隐藏细节；导出可运行 jar 后务必手动检查其 Manifest 或用
jar -tf app.jar | grep MyApp确认类是否存在
现代项目中的实际处理建议
纯命令行已少见，但理解底层逻辑能快速定位构建或部署问题：
- Maven 项目：编译输出到
target/classes，依赖 jar 在target/lib；用mvn exec:java时它自动构造 classpath；生成 fat-jar（如用spring-boot-maven-plugin）则把所有依赖打包进一个 jar，不再依赖外部 classpath - Spring Boot 应用：默认以
BOOT-INF/classes/和BOOT-INF/lib/为内部 classpath 结构，通过自定义类加载器加载 —— 此时你传的-cp只影响启动引导类（org.springframework.boot.loader.JarLauncher），不影响业务类 - Docker 部署时：确保
COPY指令把 jar 和依赖目录完整复制，且ENTRYPOINT ["java", "-cp", "app.jar:lib/*", "MyMain"]中的通配符lib/*被 JVM 正确展开（JDK 6+ 支持，但不能写成lib/*.jar）
