CLASSPATH 环境变量已基本退出主流实践，因其易引发版本冲突、被IDE/构建工具忽略、JDK默认支持当前目录且模块系统弱化其作用；推荐使用-cp参数、MANIFEST.MF的Class-Path或构建工具自动管理。
CLASSPATH 环境变量在现代 Java 开发中基本已退出主流实践，它不是“配置对了就能用”的常规环境变量，而是一个容易引发隐性问题的遗留机制。
为什么 CLASSPATH 现在不推荐设
它全局生效，一次设置影响所有 Java 进程：一个项目依赖 Jackson 2.15，另一个必须用 2.12，环境变量只能写一个版本，必然冲突；IDE（如 IntelliJ）和构建工具（Maven/Gradle）完全忽略它，改了也白改；JDK 5 起默认包含当前目录（.），简单运行单个类根本不需要设；Java 9+ 模块系统进一步弱化其作用，-cp 仍是兼容入口，但 CLASSPATH 已无底层支撑。
真正起效的 classpath 设置方式
-
命令行 -cp 或 -classpath 参数：最直接可靠，优先级最高，会完全覆盖环境变量。例如：
java -cp ".:lib/spring-web-6.1.jar:config" MyApp（Linux/macOS）或java -cp ".;lib\spring-web-6.1.jar;config" MyApp（Windows） -
JAR 包内 MANIFEST.MF 的 Class-Path 属性：适合打包分发的可执行 JAR，路径为相对路径，空格分隔，如：
Class-Path: lib/gson.jar lib/logback.jar config/ -
构建工具自动组装：Maven 执行
mvn exec:java或 Gradle 执行gradle run时，会把target/classes、build/classes和全部依赖 JAR 自动拼进 -cp，无需人工干预
极少数仍可能用到 CLASSPATH 的场景
仅限无构建工具、纯脚本驱动的轻量工具链，例如：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 运维人员写了一个通用诊断类
HeapDumper.class，希望在任意目录下直接运行java HeapDumper，不带任何参数 - 老版本 Ant 构建脚本显式读取 CLASSPATH 加载共享工具库（现代项目已淘汰）
- 某些嵌入式容器（如极老 Tomcat 7.x）启动时会合并 CLASSPATH 到启动类路径
即便在这些场景，也建议用 shell/batch 封装脚本临时导出 CLASSPATH，而非设为系统级永久变量。
立即学习“Java免费学习笔记（深入）”；
常见误区与排错提示
- 在 IDE 里能跑通，命令行报
NoClassDefFoundError？大概率是忘了加-cp，不是环境变量没设对 - 写了
CLASSPATH=lib/*却不生效？确认 JDK 版本 ≥ 6（通配符支持起点），且路径分隔符与系统匹配（Windows 用 ;，Linux/macOS 用 :） - 用双引号包裹含空格路径（如
"C:\my libs\tool.jar"）？JVM 会静默跳过，不报错也不加载 - 想验证实际生效的 classpath？加
-verbose:class启动，或用System.getProperty("java.class.path")在代码中打印
