Java启动时classpath未生效的典型表现是NoClassDefFoundError或“Could not find or load main class”，根本原因是JDK 5+默认忽略系统CLASSPATH环境变量；应优先使用-cp/-classpath参数显式指定，且其优先级最高、完全覆盖其他来源。
Java启动时classpath没生效的典型表现
运行 java MyClass 报错 Exception in thread "main" java.lang.NoClassDefFoundError: xxx 或 Could not find or load main class MyClass，大概率是 classpath 没配对——不是环境变量写错了，而是 Java 启动机制根本**不读取系统级 CLASSPATH 环境变量**（JDK 5+ 默认忽略）。别急着改 CLASSPATH 系统变量，先确认你用的是哪种加载方式。
-cp 和 -classpath 参数优先级最高
显式传入的 -cp（或 -classpath）会完全覆盖所有其他 classpath 来源，包括当前目录、jar 包内 MANIFEST.MF 的 Class-Path，以及任何环境变量。这是最可控、最推荐的方式。
- 多个路径用
:（Linux/macOS）或;（Windows）分隔，例如：java -cp ".:lib/commons-lang3.jar:config/" MyApp -
.表示当前目录，必须显式写出；默认不包含 - 路径中含空格需用引号包裹：
java -cp "lib/my jar.jar:." MyApp - 如果同时用了
-jar，-cp会被直接忽略——-jar只认 jar 包内MANIFEST.MF的Class-Path
为什么设了 CLASSPATH 环境变量却没用
JDK 5 起，默认禁用系统 CLASSPATH 环境变量，除非显式启用 -Djava.class.path=... 或使用 -Xbootclasspath 类参数。强行设置环境变量反而容易引发冲突：比如 IDE 和命令行行为不一致、不同项目间 classpath 污染。
- 检查是否真被读取：
java -XshowSettings:properties -version 2>&1 | grep class\.path - 若输出中
java.class.path = .，说明环境变量未生效 - 临时启用（不推荐）：
CLASSPATH=".:lib/*" java MyApp—— 但lib/*在 JDK 6+ 才支持通配符，且仅对java -cp有效，对环境变量无效
IDE 和构建工具绕过环境变量的真相
IntelliJ、Eclipse、Maven、Gradle 全部自行组装 classpath 并通过 -cp 传给 JVM，它们压根不查 CLASSPATH 环境变量。这也是为什么你在终端里设了环境变量，IDE 运行却完全不受影响。
立即学习“Java免费学习笔记（深入）”；
- Maven 默认 classpath 来自
target/classes+dependencies，由maven-surefire-plugin注入-cp - Gradle 使用
JavaExectask 的classpath属性，与系统变量隔离 - IDE 的「Run Configuration」里可查看实际执行的
java -cp ...命令，那是唯一可信的 classpath 来源
真正要盯住的从来不是环境变量，而是每次 java 命令背后那个具体的 -cp 值。它在哪生成、有没有漏掉 .、通配符是否被 shell 展开、jar 包路径是否拼错——这些细节比背概念重要得多。
