CLASSPATH 环境变量不是必须设置的，设了反而容易报错；JDK 5 起 JVM 默认忽略它，导致“Could not find or load main class”等错误，推荐始终使用 -cp 参数显式指定类路径，优先级最高且行为可控。
Java 中 classpath 环境变量不是“必须设置”的，而且**设了反而容易报错**。真正安全、可靠、不报错的方式，是根本不用它——改用 -cp 或 -classpath 命令行参数。
为什么设 CLASSPATH 环境变量常报错
从 JDK 5 开始，JVM 默认忽略系统级 CLASSPATH 环境变量。即使你成功设置了它，运行 java 或 javac 时大概率也完全不读取。典型表现包括：
- Could not find or load main class Xxx
- java.lang.NoClassDefFoundError
- 明明类在当前目录，却提示找不到
这是因为环境变量没生效，而你误以为它起了作用，结果掩盖了真实路径问题。
正确做法：用 -cp 显式指定（推荐）
每次运行时明确告诉 JVM 类在哪，优先级最高、行为可预测、不污染全局环境：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
立即学习“Java免费学习笔记（深入）”；
- 包含当前目录必须写 .：
java -cp ".;lib/utils.jar" MyApp（Windows）或java -cp ".:lib/utils.jar" MyApp（Linux/macOS） - 路径含空格需加引号：
java -cp "lib/my app.jar:." - 多个 JAR 用分号（Win）或冒号（Mac/Linux）分隔，不能混用
- 如果用了
-jar，-cp会被直接忽略——此时应检查 JAR 包内META-INF/MANIFEST.MF的Class-Path字段
如果非要用环境变量（不推荐，仅限简单场景）
仅当所有项目共享同一套依赖、且你完全掌控运行环境时才考虑。务必注意：
- Windows：在“系统环境变量”中新建 CLASSPATH，值为
.;C:\myproject\classes;C:\lib\utils.jar（结尾不要加分号） - Linux/macOS：在
~/.bashrc或~/.zshrc中添加export CLASSPATH=".:/path/to/classes:/path/to/lib.jar" - 必须显式包含 .，否则当前目录的类无法加载
- 避免使用通配符（如
lib/*）在环境变量中——它只对-cp有效，对 CLASSPATH 无效
IDE 和构建工具根本不看 CLASSPATH
IntelliJ、Eclipse、Maven、Gradle 全部自行组装 classpath 并通过 -cp 传给 JVM。你在终端里设的 CLASSPATH 对它们毫无影响。调试时，直接看 IDE 运行日志里实际执行的 java -cp ... 命令，那才是唯一可信的 classpath 来源。
