CLASSPATH 是 JVM 加载类和资源的核心路径，需通过 -cp 显式指定；手动设系统级 CLASSPATH 易引发冲突且不可靠，推荐用构建工具或 IDE 自动管理。
CLASSPATH 是什么，Java 为什么需要它
Java 运行时靠 CLASSPATH 告诉 JVM 在哪找类文件（.class）和资源（如 META-INF/MANIFEST.MF）。它不是可有可无的“环境变量”，而是 JVM 加载类的核心路径依据。不设或设错，常见报错是 ClassNotFoundException 或 NoClassDefFoundError。
如何在命令行中临时设置 CLASSPATH
临时设置只对当前终端会话生效，适合调试、单次运行。注意：Windows 和 Linux/macOS 的分隔符不同，且必须用 -cp 或 -classpath 显式传给 java 命令才可靠——直接改环境变量再运行 java 很可能被忽略。
- Linux/macOS：
java -cp ".:lib/commons-lang3-3.12.0.jar:build/classes" com.example.Main
- Windows：
java -cp ".;lib\commons-lang3-3.12.0.jar;build\classes" com.example.Main
-
.表示当前目录，必须显式写出；JVM 不会默认搜索当前目录 - 如果同时用了
-cp和环境变量CLASSPATH，-cp优先级更高，环境变量会被完全忽略
IDE 和构建工具如何绕过 CLASSPATH 手动配置
现代开发中，手动设 CLASSPATH 环境变量几乎从不推荐。IDE（IntelliJ / Eclipse）和构建工具（Maven / Gradle）通过自己的机制管理依赖路径，它们生成的运行配置里会自动拼出正确的 -cp 参数，根本不需要你碰系统级 CLASSPATH。
- Maven 默认把
target/classes和所有dependencyJAR 合并进启动命令的-cp - IntelliJ 在 Run Configuration → Classpath 里显示实际生效路径，点开就能验证是否包含你要的 JAR
- 如果你在 IDE 里能跑通，但命令行报
ClassNotFoundException，大概率是没用-cp指定路径，而不是环境变量没设对
什么时候真要改系统级 CLASSPATH 环境变量
极少数情况：你写了一个纯 Java 工具类（无构建工具），又希望在任意目录下用 java MyTool 直接运行（不加 -cp），这时才考虑设系统级 CLASSPATH。但风险很高：
立即学习“Java免费学习笔记（深入）”；
- 全局污染：一个项目依赖旧版
log4j，另一个依赖新版，环境变量只能设一个版本 - 路径失效：相对路径（如
./lib/*.jar）在不同工作目录下行为不可控 - JDK 自带工具（如
jps、jstat）可能意外受干扰 - Windows 下若用双引号包裹含空格的路径（
"C:\my libs\tool.jar"），JVM 会直接解析失败，不报错也不加载
真正稳定的方案永远是：用 -cp 显式声明，或交给 Maven/Gradle 管理。系统级 CLASSPATH 是遗留陷阱，不是解决方案。
