CLASSPATH 是告诉 Java 加载类文件或 JAR 包的路径；非必需，JVM 默认使用当前目录（.），仅在加载外部类时需显式配置，可通过 -cp 参数（优先）、环境变量或 IDE 设置，现代构建工具如 Maven 自动管理。
CLASSPATH 是什么，Java 启动时怎么用它
CLASSPATH 不是 Java 运行的必需环境变量；JVM 默认会把当前目录（.）当作类路径。只有当你需要加载非当前目录、非 java.lang.*、非 rt.jar 中的类（比如自定义 .jar 或 .class 文件）时，才需要显式配置它。
它的作用很直接：告诉 java 和 javac 命令去哪找 .class 文件或 .jar 包。不是所有场景都要设——比如只运行单个 .class 文件且在当前目录，完全不用碰 CLASSPATH。
三种设置方式的区别和适用场景
CLASSPATH 可通过环境变量、命令行参数或 IDE 配置设置，优先级从高到低是：-cp / -classpath > 环境变量 CLASSPATH > 默认（.）。
- 命令行临时设置（推荐）：最可控，不污染系统，适合调试和脚本
java -cp "lib/spring-core-5.3.30.jar:lib/commons-lang3-3.12.0.jar:." MyApp
注意：: 用于 Linux/macOS，Windows 用 ;；路径末尾加 . 表示包含当前目录，否则当前目录不会被搜索。
立即学习“Java免费学习笔记（深入）”；
- 环境变量（慎用）：全局生效，容易引发冲突，比如多个项目依赖不同版本的同一 jar
Linux/macOS：
export CLASSPATH="/path/to/myapp/classes:/path/to/lib/*.jar"
Windows cmd：
set CLASSPATH=C:\myapp\classes;C:\myapp\lib\*.jar
-
IDE（如 IntelliJ / Eclipse）：实际不操作 CLASSPATH 变量，而是通过模块依赖（Module Dependencies）或 Project Structure 配置 classpath entries，底层生成的是
-cp参数传给 JVM
常见 CLASSPATH 错误和排查方法
绝大多数 NoClassDefFoundError 或 ClassNotFoundException 都不是“类没写”，而是 JVM 根本没找到那个类文件——根源常出在 CLASSPATH 配置上。
-
NoClassDefFoundError: org/apache/commons/logging/Log→ 检查是否漏加commons-logging.jar，或 jar 路径写错（比如写成commons-logging-1.2.jar但实际是commons-logging-1.2.1.jar） - 用
java -verbose:class -cp ... MyApp查看 JVM 实际加载了哪些类及其来源路径，确认目标类是否出现在输出里 - 路径含空格未加引号 → Linux 下会被 shell 拆成多个参数，Windows 下可能报 “无法识别的选项”
- 使用
*通配符时，只匹配 jar 文件，不匹配 class 文件或子目录；且 JDK 6+ 才支持，老版本需展开写全
现代项目中 CLASSPATH 的真实地位
Maven/Gradle 构建的项目几乎从不手动设 CLASSPATH。它们通过 pom.xml 或 build.gradle 声明依赖，构建时自动合成运行时 classpath，并生成带完整 -cp 的启动脚本（如 target/app.jar 的 MANIFEST.MF 中有 Class-Path: 字段）。
如果你在写一个需要分发的 Java 工具，别靠用户自己设 CLASSPATH；打包成 fat jar（如用 Maven Shade 插件），或提供封装好的 shell/bat 启动脚本，里面已写死正确的 -cp。
真正要小心的，是混合使用环境变量 CLASSPATH 和命令行 -cp ——前者会被后者完全忽略，但很多人以为是“叠加”，结果删掉环境变量后反而跑不起来了。
