CLASSPATH用于指定JVM查找类文件的路径，非必需但自定义路径下必须配置；默认仅搜索当前目录和核心库，错误配置易导致ClassNotFoundException；优先级低于-cp参数，.代表当前工作目录而非源文件目录；Java 9+中模块化JAR优先走--module-path，CLASSPATH对其无效。
CLASSPATH 是用来告诉 JVM 去哪找类文件的
它不是启动 Java 程序的必需项，但一旦你用到自定义路径下的 .class 或 .jar，JVM 就得靠它定位。默认情况下，JVM 只查当前目录（.）和 rt.jar 等核心库，不自动扫描子目录或项目结构。
常见错误现象：ClassNotFoundException 或 NoClassDefFoundError，尤其在命令行运行 java Main 时突然报错，而 IDE 里却正常——大概率是 CLASSPATH 没配或配错了。
- 只影响
java和javac命令的行为，不影响 IDE（如 IntelliJ、Eclipse），它们用自己的类路径管理逻辑 - Windows 下用分号
;分隔路径，Linux/macOS 用冒号:，写反会导致整个 CLASSPATH 被忽略 - 路径中含空格必须用英文双引号包裹，比如
"./my lib/commons-lang3.jar"，否则 JVM 会截断 - 重复添加同一 JAR 不报错，但可能引发版本冲突（比如两个不同版本的
slf4j-api.jar）
什么时候真该手动设 CLASSPATH
绝大多数现代项目根本不需要碰它：Maven/Gradle 构建时自动组装类路径，IDE 启动配置也内置了 classpath 控制。手动设 CLASSPATH 主要出现在这几种场景：
- 纯命令行开发，没构建工具，比如写个单文件
Hello.java，依赖一个本地utils.jar - 运行老系统脚本，里面硬编码了
java -cp ...，但环境变量又干扰了它 - 调试类加载问题，比如想验证某个类是否被优先加载，临时加一个测试路径
注意：-cp（或 --class-path）参数的优先级永远高于环境变量 CLASSPATH。也就是说，只要命令里写了 java -cp ./lib/a.jar Main，系统级的 CLASSPATH 就完全不起作用。
立即学习“Java免费学习笔记（深入）”；
CLASSPATH 中的 .（点）代表什么
它代表“当前工作目录”，不是“当前文件所在目录”。这个区别非常关键，也是最容易踩坑的地方。
- 执行
java -cp . MyApp时，JVM 查找的是你运行命令时所在的目录下的MyApp.class，而不是MyApp.java所在目录 - 如果你在项目根目录下执行
javac src/Main.java，生成的Main.class在src/下；但java -cp . Main会去根目录找Main.class，自然失败 - 正确做法是：编译后把 class 文件放到符合包结构的路径中，比如
src/com/example/Main.java编译成out/com/example/Main.class，再用java -cp out com.example.Main
Java 9+ 对 CLASSPATH 的实际影响
模块系统（JPMS）上线后，CLASSPATH 并没有被废除，但它对模块化 JAR 的行为变了：如果一个 JAR 包含 module-info.class，JVM 会优先按模块路径（--module-path）加载，此时 CLASSPATH 里的同名类会被忽略。
- 混合使用时，非模块化类仍走 CLASSPATH，模块化类走 module-path，两者互不干扰但也不叠加可见性
-
java -cp lib/a.jar:lib/b.jar Main在 Java 17 下仍有效，但若a.jar是模块化的，它的exports不会对 CLASSPATH 中的类生效 - 建议新项目直接用
--module-path+--add-modules，别依赖 CLASSPATH 做模块间依赖管理
真正麻烦的是那种半模块化项目：一部分 jar 是模块化的，另一部分还是传统打包方式，这时候 CLASSPATH 配得再准，也可能因为模块读取限制导致类找不到——这不是路径问题，是模块封装本身在拦你。
